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Did you find an error? 


Please let us know. 
Using any web browser, go to txplo.re/kicadr, and fill in the form. 
We'll get it fixed right away. 


About the author 


Dr. Peter Dalmaris is an educator, an electrical engineer, electronics hobbyist, and Maker. 
Creator of online video courses on DIY electronics and author of several technical books. 
Peter has recently released his book ‘Maker Education Revolution’, a book about how Mak- 
ing is changing the way we learn and teach in the 21st century. 


As a Chief Tech Explorer since 2013 at Tech Explorations, the company he founded in Syd- 
ney, Australia, Peter’s mission is to explore technology and help educate the world. 

Tech Explorations offers educational courses and Bootcamps for electronics hobbyists, 
STEM students, and STEM teachers. 


A lifelong learner, Peter’s core skill lies in explaining difficult concepts through video and 
text. With over 15 years of tertiary teaching experience, Peter has developed a simple yet 
comprehensive style in teaching that students from all around the world appreciate. 


His passion for technology and the world of DIY open-source hardware, has been a domi- 


nant driver that has guided his personal development and his work through Tech Explora- 
tions. 
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About Tech Explorations 


Tech Explorations creates educational products for students and hobbyists of electron- 
ics who rather utilize their time making awesome gadgets instead of searching endlessly 
through blog posts and Youtube videos. 

We deliver high-quality instructional videos and books through our online learning platform, 
txplore.com. 

Tech Explorations courses are designed to be comprehensive, definitive and practical. 
Whether it is through video, ebook, blog or email, our delivery is personal and conversa- 
tional. 

It is like having a friend showing you something neat... the «AHA» moments just flow! 


Peter left his career in Academia after his passion for electronics and making was rekindled 
with the arrival of his first Arduino. Although he was an electronics hobbyist from a young 
age, something the led him to study electrical and electronics engineering in University, the 
Arduino signalled a revolution in the way that electronics is taught and learned. 

Peter decided to be a part of this revolution and has never looked back. 

We know that even today, with all the information of the world at your fingertips, thanks to 
Google, and all the components of the world one click away, thanks to eBay, the life of the 
electronics hobbyist is not easy. 

Busy lifestyles leave little time for your hobby, and you want this time to count. 

We want to help you to enjoy your hobby. We want you to enjoy learning amazing practical 
things that you can use to make your own awesome gadgets. 

Electronics is a rewarding hobby. Science, engineering, mathematics, art, and curiosity all 
converge in a tiny circuit with a handful of components. 


Our courses have been used by over 70,000 people across the world. 

From prototyping electronics with the Arduino to learning full-stack development with the 
Raspberry Pi or designing professional-looking printed circuit boards for their awesome 
gadgets, our students enjoyed taking our courses and improved their making skills dra- 
matically. 


Please check out our courses at techexplorations.com and let us be part of your tech ad- 
ventures. 
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About KiCad 6 


KiCad 6 is the world’s best open-source and free-to-use Printed Circuit Board tool. Its latest 
iteration, version 6, is packed with features usually found only in expensive commercial 
CAD tools. 

KiCad 6 is a modern, cross-platform application suite built around schematic and design 
editors, with auxiliary applications: a custom symbol and footprint creator, calculators, a 
Gerber file viewer, and an image converter for customizing graphics in silkscreen or copper. 
KiCad 6 is a stable and mature PCB tool, a perfect fit for electronic engineers and hobby- 
ists. With KiCad 6, you can create PCBs of any complexity and size without the constraints 
associated with the commercial packages. 


Here are some of the most significant improvements and features in KiCad 6, both over 
and under the hood: 


e Modern user interface, completely redesigned from earlier versions 

e Improved and customizable electrical and design rule checkers 

e Theme editor allowing you to fully customize the look of KiCad on your screen 

e Ability to import projects from Eagle, CADSTART, and more 

e Enhanced bus handling 

e Full control over the presentation of information by the layout editor: set the visibility, 
color, and attribute of any board element, and create presets 

e Use of Filters to define which elements of a layout are selectable - an essential feature 
for complex boards 

e Enhanced interactive router helps you draw single tracks and differential pairs, and 
define their attributes (length, gaps, angles, etc.) with precision 

e New or enhanced tools to draw tracks, measure distances, tune track lengths, etc. 

e Enhanced tool for creating filled zones 

e Data exchange with other CAD applications facilitated by a customizable coordinate 
system 

e Realistic ray-tracing capable 3D viewer 


e 12 


About this book 


About this book 


Printed circuit boards (PCBs) are, perhaps, the most undervalued component of modern 
electronics. Usually made of fibreglass, PCBs are responsible for holding in place and inter- 
connecting the various components that make virtually all electronic devices work. 

The design of complex printed circuit boards was something that only skilled engineers 
could do. These engineers used expensive computer-aided design tools. The boards they 
designed were manufactured in exclusive manufacturing facilities in large numbers. 

Not anymore. 

During the last 20 years, we have seen high-end engineering capabilities becoming avail- 
able to virtually anyone that wants them. Computer-aided design tools and manufacturing 
facilities for PCBs are one mouse click away. 

KiCad is one of those tools. Perhaps the world’s most popular (and best) computer-aid- 
ed design tool for making printed circuit boards, KiCad is open source, fully featured, 
well-funded and supported, well documented. It is the perfect tool for electronics engineers 
and hobbyists alike, used to create amazing PCBs. KiCad has reached maturity and is now 
a fully featured and stable choice for anyone that needs to design custom PCBs. 

This book will teach you to use KiCad. Whether you are a hobbyist or an electronics en- 
gineer, this book will help you become productive quickly, and start designing your own 
boards. 

Are you a hobbyist? Is the breadboard a bottleneck in your projects? Do you want to be- 
come skilled in circuit board design? If yes, then KiCad and this book are a perfect choice. 
Use KiCad to design custom boards for your projects. Don’t leave your projects on the 
breadboard, gathering dust and falling apart. 

Complete your prototyping process with a beautiful PCB and give your projects a high-qual- 
ity, professional look. 

Are you an electronics engineer? Perhaps you already use a CAD tool for PCB design. 
Are you interested in learning KiCad and experience the power and freedom of open-source 
software? If yes, then this book will help you become productive with KiCad very quickly. 
You can build on your existing PCB design knowledge and learn KiCad through hands-on 
projects. 

This book takes a practical approach to learning. It consists of four projects of incremental 
difficulty and recipes. 

The projects will teach you basic and advanced features of KiCad. If you have absolutely no 
prior knowledge of PCB design, you will find that the introductory project will teach you the 
very basics. You can then continue with the rest of the projects. You will design a board for 
a breadboard power supply, a tiny Raspberry Pi HAT, and an Arduino clone with extended 
memory and clock integrated circuits. 

The book includes a variety of recipes for frequently used activities. You can use this part 
as a quick reference at any time. 

The book is supported by the author via a page that provides access to additional resourc- 
es. Signup to receive assistance and updates. 
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Requirements 


To make the most out of this work, you will need a few things. You probably already have 
them: 

e A computer running Windows, Mac OS or Linux. 

e Access to the Internet. 

e A mouse with at least two buttons and a scroll wheel. I use a Logitech MX Master 

2S mouse (see https://amzn.to/2ClySq0). 
e Ability to install software. 
e Time to work on the book, and patience. 
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How to read KiCad 6 Like A Pro 


I wrote this third edition of KiCad Like A Pro so that you can use it as a learning guide 
and as a reference source. It now consists of two separate but complementary books : 
Fundamentals and Projects | Getting started with the world’s best open-source 
PCB tool (548 pages), and Projects, Tips, and Recipes | Mastering PCB design with 
real-world projects (400 pages). 


PCS J Parts 1 to 10 PTA: Parts 11, 12, 13 


Fundamentals and Projects 548 pages Projects, Tips, and Recipes 400 pages 


d The book you are 


ae holding now! 


t 


All examples, descriptions and procedures are tested on the nightly releases of KiCad 6 
(also known as KiCad 5.99) and in KiCad 6 RC1. 

If you have never used KiCad and have little or no experience in PCB design, I recommend 
you read it in a linear fashion. Don’t skip the early chapters in parts 1 to 8 because those 
will give you the fundamental knowledge on which you will build your skill later in the book. 
If you skip those chapters, you will have gaps in your knowledge that will make it harder 
for you to progress. 

If you have a good working knowledge of PCB design, but you are new to KiCad, you can 
zoom through the first chapters, and then proceed to the projects in Parts 9 and 10. 
Throughout this work, you will find numerous figures that contain screenshots of KiCad. To 
create these screenshots, I used KiCad 5.99 and KiCad 6.0 RC1 running on Mac OS. If you 
are using KiCad under Windows or Linux, do not worry: KiCad works the same across these 
platforms, and even looks almost the same. 

Although I took care to produce images that are clear, there are cases where this was not 
possible. This is particularly true in screenshots of an entire application window, meant to 
be displayed in a large screen. The role of these images is to help you follow the instructions 
in the book as you are working on your computer. There is no substitute to experimenting 
and learning by doing, so the best advice I can give is to use this work as a text book and 
companion. Whenever you read it, have KiCad open on your computer and follow along 
with the instructions. 

This work has a web page with resources designed to maximize the value it delivers to you, 
the reader. Please read about the book web page, what it offers and how to access it in the 
section ‘The book web page’, later in this introductory segment. 

Finally, you may be interested in the video course version of this book. This course spans 
over 25 hours of high-definition video, with detailed explanations and demonstrations of all 
projects featured in the book. The video lectures capture techniques and procedures that 
are just not possible to do so in text. 
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Please check in the book web page for updates on this project. Be sure to subscribe to the 
Tech Explorations email list so I can send you updates. 


The book web page 


As a reader of this book, you are entitled access to its online resources. 
You can access these resources by visiting the book’s web page at txplo.re/kicadr. 
The two available resources are: 

1. Photos and schematics. Get high-res copies of the photos, schematics, and 
layouts that appear in the book. 

2. An errata page. As I correct bugs, I will be posting information about these 
corrections in this page. Please check this page if you suspect that you have 
found an error. If an error you have found is not listed in the errata page, please 
use the error report form in the same page to let me know about it. 
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Foreword by Wayne Stambaugh 


In 1992 Jean-Pierre Charras started the KiCad project. From it’s humble beginnings as one 
man’s goal to provide an electronics design application for his students to a full fledged 
open source project with a significant number of contributors, KiCad has become the choice 
for users who prefer an open source solution for electronics design. As the feature parity 
gap from proprietary EDAs continues to close, KiCad will continue to become more widely 
accepted and influential. 

One of the enduring hallmarks of a successful open source software project is the publica- 
tion of a <how to» book. With the publication of «KiCad Like a Pro», the KiCad project joins 
the other well known open source projects with that distinction. Whether you are a begin- 
ner or a seasoned professional user, this book has something for everyone. From properly 
configuring and using KiCad to design your first printed circuit board to advanced topics 
such as using git for version control this book is a valuable resource for any KiCad user. 


Wayne Stambaugh 
KiCad Project Leader 


e 17 


KiCad Like a Pro, Projects, Tips and Recipes 


An introduction: Why KiCad? 


Since KiCad first appeared in the PCB CAD world in 1992, it has gone through 6 major 
versions and evolved into a serious alternative to commercial products. I have been using 
KiCad almost daily since version 4 when I published the first edition of KiCad Like a Pro. 
Once thought clunky and barely usable, it is now a solid, reliable CAD application. KiCad 
has been consistently closing the feature and performance gap against its commercial 
competitors. It has made leaps in adding powerful features and has significantly improved 
its stability. 

Combined with the benefits of free and open-source software’, I believe that KiCad is sim- 
ply the best PCB CAD software for most use cases. 

One of those benefits is KiCad's very active and growing community of users and contrib- 
utors. KiCad has a dedicated developer team, supported by contributing organizations like 
CERN, the Raspberry Pi Foundation, Arduino LLC, and Digi-Key Electronics. The community 
is also active in contributing funds to cover development costs. Since joining the Linux 
Foundation, the KiCad project has received around $90,000 in donations. The project used 
this money to buy development time and funding developer conference travel and meet- 
ups. To a large extent, this alone guarantees that KiCad's development will accelerate and 
continue to in the future. 

Supporting the KiCad core team is the KiCad community. The community consists of over 250 
thousand people worldwide that have downloaded a copy. These people support the KiCad 
project in various ways: they write code, create and share libraries, and help others learn. 
They write documentation, record videos, report bugs, and share hacks. During the KiCad 6 
development cycle, the KiCad repository had around 14600 commits from the community. 
Based on this number, KiCad 6 is the most significant KiCad version ever in terms of changes. 
Another signal of the strength of the KiCad community is that KiCad 6 includes completed 
or nearly completed translations to nearly 20 languages. No other CAD software that I am 
aware of can boast this. 

PCB manufacturers have also taken notice. Many of them now publish KiCad-specific tutori- 
als, explaining how to order your boards. Some have made it possible to upload the KiCad 
native layout file from your project instead of generating multiple Gerber files. 

And finally, KiCad is part of an expanding CAD ecosystem. You will find KiCad-compati- 
ble component libraries on the Internet's major repositories, such as Snapeda* and Octo- 
part’, as well as native support in PCB project version control software for teams, such as 
CADLAB. io. 

KiCad's development and prospects have never been brighter than now. KiCad's roadmap 
has exciting new features and capabilities such as grouping board objects into reusable 
snippets and a stable Python API. 

Why do I use KiCad? Because it is the perfect PCB software for my use case. 

I am an electrical engineer with a background in electronics and computer engineering. 
But, above all, I am a technology educator and electronics hobbyist. The majority of my 
PCB projects eventually find themselves in my books and courses. My projects are very 


BR 


https://en.wikipedia.org/wiki/Free_and_open-source_software 
https://Snapeda.com 
https://Octopart.com 
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similar to those of other hobbyists in terms of complexity and size. I make things for my Ar- 
duino and Raspberry Pi courses. As a hobbyist, KiCad proved to be the perfect tool for me. 
Your use case may be different. You may be a university student completing an engineering 
degree. You may be a hobbyist or solo developer working in a startup company. You may 
be part of a team working on commercial projects that involve highly integrated multi-layer 
PCBs. 

To help you decide whether KiCad is right for you, I have compiled a list of 12 KiCad Ben- 
efits. This list contained ten items in the second edition of the book. I added the last two 
items to highlight additional benefits brought about with KiCad 6. 

Here they are: 

Benefit 1: KiCad is open source. This is very important, especially as I spend more time 
creating new and more complicated boards. Open source, by definition, means that the 
code base of the application is available for anyone to download and compile on their com- 
puter. It is why Linux, Apache, and WordPress essentially run the Internet (all of them open- 
source). While I am not extreme in my choices between open source and closed source 
software, whenever a no-brainer open-source option does appear, like KiCad, I take it. 
Benefit 2: It is free! This is particularly important for hobbyists. CAD tools can be ex- 
pensive. This is worsening with most CAD software companies switching to a subscrip- 
tion-based revenue model. When you are a hobbyist or student or bootstrapping for a 
startup, regular fees do add up. Not to mention that most of us would not be using even 
half of the features of commercial CAD software. It is hard to justify spending hundreds of 
dollars on PCB software when there is KiCad. This brings me to Benefit 3 

Benefit 3: KiCad is unlimited. There are no "standard", "premium" and "platinum" ver- 
sions to choose from. It's a single download, and you get everything. While there are com- 
mercial PCB tools with free licensing for students or hobbyists, there are always restrictions 
on things like how many layers and how big your board can be, what you can do with your 
board once you have it, who can manufacture your board, and much more. And there is 
always the risk that the vendor may change the deal in the future where you may have to 
pay a fee to access your projects. I'll say again: KiCad is unlimited and forever! This is so 
important that I choose to pay a yearly donation to CERN that is higher than the cost of an 
Autodesk Eagle license to do my part in helping to maintain this. 

Benefit 4: KiCad has awesome features. Features such as interactive routing, length 
matching, multi-sheet schematics, configurable rules checker, and differential routing are 
professional-grade. While you may not need to use some of them right away, you will use 
them eventually. You can add new features through third-party add-ons. The external au- 
torouter is one example. The ability to automate workflows and extend capabilities through 
Python scripts is another. 

Benefit 5: KiCad is continually improved. Especially since CERN & Society Foundation* 
became involved in their current capacity, I have seen a very aggressive and successfully 
implemented roadmap. When I wrote the first version of this list (August 2018), KiCad 5 
was about one month old. The funding for KiCad 6 was already complete, and the road map 
living document was published. Three years later, KiCad 6 was delivered with promises 
fulfilled. Now, with KiCad 6 published, the road map for the future® looks just as exciting. 


4  https://cernandsocietyfoundation.cern/projects/kicad-development 
5 https://gitlab.com/kicad/code/kicad/-/wikis/KiCad-Future-Versions-Roadmap 
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Benefit 6: KiCad's clear separation of schematics and layout is a bonus to learning and 
using it. Users of other PCB applications often find this confusing, but I believe that it is an 
advantage. Schematic design and layout design are indeed two different things. Schematic 
symbols can be associated with different footprints that depend on the project require- 
ments. You can use the schematic editor independently of the layout editor or in sync. I 
often create schematic diagrams for my courses that I have no intention of converting into 
PCBs. I also often create multiple versions of a board using the same schematic. This sep- 
aration of roles makes both scenarios easy. 

Benefit 7: I can make my boards anywhere: I can upload my project to any online fabrica- 
tor that accepts the industry-standard Gerber files; I can upload it to an increasing number 
of fabricators that accept the native KiCad layout file; and, of course, I can make them at 
home using an etching kit. 

Benefit 8: KiCad works anywhere. Whether you are a Mac, Windows, or Linux person, you 
can use KiCad. I use it on all three platforms. I can take my KiCad 6 project from the Mac 
and continue working on Windows 10 without worrying about any software or project files 
glitches. 

Benefit 9: KiCad is very configurable. You can assign your favorite keyboard hotkeys and 
mapping, and together with the mouse customizations, you can fully adapt it to your pref- 
erences. With the additions of the plugin system* and the Python API, , it will be possible to 
extend your instance of KiCad with the exact features you need (or write them). 

Benefit 10: If you are interested in creating analog circuits, you will be happy to know 
that KiCad ships with SPICE. You can draw the schematic in Eeschema and then simulate 
it in SPICE without leaving KiCad. This integration first appeared in KiCad 5, and it is now 
a stable feature. 

Benefit 11: In the past, KiCad's release cycle was somewhat chaotic. New major versions 
would come out every two or three years, but no one knew ahead of time. In the future, 
KiCad will operate in a yearly release cycle. This is good for two reasons: One, commercial 
users who can now better predict how the software they depend on will change and when. 
Two, as KiCad users, all of us will be able to expect a reliable development schedule that 
prioritizes reliability. KiCad is now mature enough to be able to evolve predictably. 
Benefit 12: KiCad is now a serious productivity tool for businesses. If you are an electron- 
ics engineer, you can proudly list it in your resume. If you are using it in your business, 
you can contract the KiCad Services Corporation, to customize the software to your exact 
requirements. I am talking about deep customization, not just changing the theme and the 
menu bars. This means that KiCad can fit precisely with your business. As far as I know, 
no commercial CAD application can do that. For the non-business users among us, we can 
expect many of these business-led improvements to flow into future software versions in 
the tradition of open-source software. 

These are the twelve most important reasons I have chosen KiCad as my tool of choice for 
designing PCBs. These reasons might not be suitable for you, but I hope you will consider 
reading this book first before making your own decision. 


6 https://techexplorations.com/blog/kicad/jon-evans-answers-kicad-6-questions/ 
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I have been using KiCad since version 4. I have packed almost everything I have learned 
as a KiCad user in this book. I have organized it in a way that will make learning KiCad 
quick. The objective of this book is to make you productive by the time you complete the 
first project, in part four. 

If you come from another PCB CAD tool and have experience designing PCBs, I only ask 
that you have an open mind. KiCad is most certainly very different from your current PCB 
tool. It looks different, and it behaves differently. It will be easier to learn it if you con- 
sciously put aside your expectations and look at KiCad like a beginner would. As per the 
Borg in Star Trek, "resistance is futile", and in learning, like in so many other aspects of life, 
you are better off if you go with the flow. 

Let's begin! 


Note: Parts 1 to 10 of the third edition of KiCad Like a Pro can be found in the book 
KiCad 6 Like A Pro | Fundamentals and Projects 

Getting started with the world’s best open-source PCB tool 

548 pages 

ISBN 978-3-89576-496-7 print 

ISBN 978-3-89576-497-4 ebook 
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Part 11 : Project - MCU datalogger 


11.1. Project - Introduction 
Welcome to Part 11. In this Part, you will design a printed circuit board for a microcon- 
troller data logger. The data logger is based on an Atmega 328P-AU microcontroller and 
is supported by two EEPROMs and a real-time clock. Additional components on the board, 
such as status LEDs with their supporting resistors, two crystal oscillators, connectors, and 
capacitors. 
You will use SMD packages for most components on a rectangular two-layer board with 
mounting holes on the four corners. 
The project highlights are: 

1. You will use Git to capture the history of the project's development. 

2. You will design two versions of the PCB: one with two layers and one with four 

layers. Both will use data from the same schematic design. 


KiCad, on its own, does not allow the creation of more than one layout for a schematic. Git 
makes this possible with the use of branches. This project will allow you to practice this 
aspect of Git-powered PCB design with KiCad. 

The schematic design contains components distributed across two sheets. You can see the 
final schematic below (sheet 1): 
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Figure 11.1.1: Sheet 1 of the project's final schematic design. 


In Sheet 1, I have placed the main components of the board. Sheet 2 contains the con- 
nectors: 
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Figure 11.1.2: Sheet 2 of the project's final schematic design. 


In the schematic design, I have used a combination of line wires and net labels. Other than 
the distribution of the components across the two sheets, the techniques I have used to 
draw the schematic should be familiar to you from previous projects. 

The most exciting aspect of this project is the layout design: you will design two versions of 
the PCB. A two-layer and a four-layer version. You can see the final version of the two-layer 
PCB layout below: 


Figure 11.1.3: The project's final layout design (two layers). 
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You can see the final four-layer PCB below: 
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Figure 11.1.4: The project's final layout design (four layers). 


The main objectives of this project are: 
1. To help you practice skills you acquired in previous projects. 
2. To use Git in a non-trivial project to extend KiCad's use cases in a single-schematic 
and multi-layout project. 
3. To gain experience in creating multi-layer PCBs. 


Below you can see the Bill of Materials for this project, as I have extracted it from the KiCad 
project (learn how later in this book): 


Reference Value Footprint 

BT1 Battery Connector_PinHeader_2.54mm:PinHeader_1x02_ 
P2.54mm_Vertical 

C1, C4 0.1uF Capacitor_SMD:C_0805_2012Metric 

C2, C3 22pF Capacitor_SMD:C_0805_2012Metric 

C5 100nF Capacitor_SMD:C_0805_2012Metric 

D1, D2 LED LED_SMD:LED_0805_2012Metric 

H1-H4 MountingHole MountingHole:MountingHole_2.1mm 
Connector_PinHeader_2.54mm:PinHeader_1x09_ 

J2 Conn_01x09_Male , 
P2.54mm_Vertical 
Connector_PinHeader_2.54mm:PinHeader_1x04_ 

Ja, 33 Conn_01x04_Male , 
P2.54mm_Vertical 
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Connector_PinHeader_2.54mm:PinHeader_2x03_ 
J4 Conn_02x03_Odd_Even , 
P2.54mm_Vertical 
R1,R2,R6 | 10K Resistor_SMD:R_0805_2012Metric 
R3, R4 4.7K Resistor_SMD:R_0805_2012Metric 
R5, R7 330 Resistor_SMD:R_0805_2012Metric 
U2 DS1337S+ Footprints: SOIC127P600X175-8N 
U1, U3 24LC1025 Package_SO:SOIC-8_5.23x5.23mm_P1.27mm 
U4 ATMEGA328P-AU Footprints: QFP80P900X900X120-32N 
Crystal:Crystal_SMD_5032-2Pin_5.0x3.2mm_HandSol- 
Y1 32.768 KHz , 
dering 
Crystal:Crystal_SMD_5032-2Pin_5.0x3.2mm_HandSol- 
Y2 16 MHz . 
dering 


Table 11.1.1: The Bill of Materials for this project. 


I used Snapeda to find the symbol-footprint pairs for U4. You should be able to find all other 
symbols and footprints in KiCad's libraries. 

In the next chapter, you will begin work on this project by creating a new KiCad project 
and Git repository. 


11.2. Create the new project and Git repository 

A primary objective of this project is to help you learn how to use Git within a KiCad project. 
If you are not familiar with Git, please consider reading the chapter "13.25. KiCad project 
management with Git" in the Recipes part of this book before continuing with the project. 
To keep the project flowing, I will not explain the meaning of each Git command that I use. 
Instead, I assume that you already know the basics of Git, and in the chapters that follow, 
I will focus on showing you how to use this knowledge in the context of a complete KiCad 
project. 

Start KiCad, and create a new KiCad project. I have named my instance of the project "MCU 
Datalogger." 
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Figure 11.2.1: Starting a new project. 
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Now that you have a project directory for the project files create a new Git repository. 
Open a terminal window and navigate to the project directory. Issue the "init" command to 
initialize a new repository: 


% git init 


Below is my command line session. The second rectangle points to the new «.git» hidden 
directory, which will contain the project's history. 


Figure 11.2.2: Creating a new Git repository. 


The new Git repository is ready. Let's start tracking the project files. Get the status of the 
repository to see what is not being tracked: 


% git status 
On branch master 


No commits yet 


Untracked files: 
(use «git add <file>...» to include in what will be committed) 


MCU Datalogger.kicad_pcb 
MCU Datalogger.kicad_pro 
MCU Datalogger.kicad_sch 


nothing added to commit but untracked files present (use «git add» to track) 


% 


The repository is not tracking any files yet, and there are no commits. The working branch 
is «master.» Three files are not being tracked. Let's track them. Use the «add» command: 


% git add. 
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You can use "git status" again to confirm that the three files are in the staging area but not 
yet committed. Go ahead and commit them using the "commit" command: 


% git commit -am "First commit of new project." 


[master (root-commit) c268ef2] First commit of new project. 
3 Files changed, 68 insertions(+) E 

create mode 100644 MCU Datalogger.kicad_pcb 

create mode 100644 MCU Datalogger.kicad_pro 

create mode 100644 MCU Datalogger.kicad_sch 


% 


Use the "status" command to confirm that the working tree is clean: 


% git status 
On branch master 
nothing to commit, working tree clean 


os 
70 


KiCad automatically creates backup and cache files that don't have to be captured in the 
repository. I also want to exclude the contents of the Gerbers directory since I can always 
generate them at will. To exclude those files, use your text editor to edit the» .gitignore» 
file. Below you can see the contents of «.gitignore»: 


fp-inFo-cache 
MCU Datalogger—backups/* 
MCUDataloggerGerber/x 


You can see the contents of my ".gitignore" file below: 


Figure 11.2.3: The contents of the ".gitignore" file. 
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At this point, you have a new KiCad project, and you are tracking it using Git. Let's continue 
with the schematic design workflow. 


11.3. Schematic design 
In this chapter, you will complete the schematic design of this PCB by following the sche- 
matic design workflow. You learned about this workflow in Part 6 of the book. 


11.3.1. Schema 1 - Setup 
In this chapter, you will set up your schematic editor. Begin by opening the Preference win- 
dow (KiCad —> Preferences). I have kept the defaults, except for the following settings: 
e Schematic Editor 
- Display Options 
- Grid thickness: 1 px 
- Min Grid spacing: 15 px 
- Colors: Using a custom theme with white background. 
- Field Name Templates: A new field named "Purpose"; visible. 
e Schematic Setup 
- Project 
- Net Classes: create a new net class with the name "Power." 
- Text Variables: created a new variable: 
- Variable Name: project_name 
- Text Substitution: MCU Datalogger with memory and clock 
- Page Settings: 
- Issue Date: copied today's date from the date field. 
- Revision: 1 
- Title: ${project_name} 


The setup is complete. Don't forget to save the project. 
Let's continue with updating the Git repository. Use the "status" command to get an up- 
date: 


% git status 
On branch master 
Changes not staged For commit: 
(use "git add <file>..." to update what will be committed) 
(use "git checkout —- <file>..." to discard changes in working directory) 


modified: MCU Datalogger.kicad_pro 
modified: MCU Datalogger.kicad_sch 


Untracked files: 
(use «git add <File>...» to include in what will be committed) 


DSPS CONE 


-gitignore 
MC Datalogger.kicad_prl 
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no changes added to commit (use «git add» and/or «git commit —a») 


% 


Git reports that there are changes in the project and schematic files and three new un- 
tracked files. I do not want to track the Mac OS system file «.DS_Store» so I will add it to 
the «.gitignore» file. The other two files should be tracked. Here is my updated «.gitignore» 


file: 


~DS_Store 

fp-inFo-cache 

MCU Datalogger—backups/x* 
MCUDataloggerGerber/x 


Add the new files to Git (using the file name instead of the wildcard «.» character), and 


commit them: 


% git add .gitignore 

% git add "MCU Datalogger.kicad_prl" 

% git commit —am "Setup of EEschema for new project." 
[master ddb72ca] Setup of EEschema for new project. 

4 files changed, 391 insertions(+), 9 deletions (-) 
create mode 100644 .gitignore 

create mode 100644 MCU Datalogger.kicad_prl 


% 


Use the "log" command to see Git's recent history: 


% git log 

commit ddb72ca7e5e8778Fcb7cOble8bf480f262635a6a (HEAD —> master) 
Author: Peter Dalmaris <peter@txplore.com> 

Date: Wed Jul 21 07:51:26 2021 +1000 


Setup of EEschema for new project. 
commit c268ef258069718c44511d36a8ed03d4038570c9 
Author: Peter Dalmaris <peter@txplore.com> 


Date: Wed Jul 21 07:35:12 2021 +1000 


First commit of new project. 


The log shows the two commits done so far, along with their commit IDs and other infor- 


mation. 
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In the previous chapter, where I created the new Git repository, I forgot to change the 
name of the «master» branch into «main.» The naming convention for the primary branch 
of Git repositories is now «main.» Online repositories, like Github, also follow this conven- 
tion. If you plan to share your KiCad project with other people using Github, you should 
consider changing the primary branch of your project repository to «main» to avoid com- 
patibility issues. I will make the name change now, so I don't forget again: 


% git branch 

* master 

% git branch -m master main 
% git branch 

* main 


% 


In the session above, I used the «branch» command to check the name of the current 
working branch. The response was «master.» In the third line, 1 used «branch -m» to re- 
name the «master» branch into «main.» In the fourth line, I confirmed that the renaming 
worked. 


If (like me) you tend to forget to remake your Git repository's default branch, you can set 
it in the Git configuration like this: 


% git config --global init.defaultBranch main 
In the next segment of this chapter, you will add the schematic symbols into the editor. 


11.3.2. Schema 2 - Symbols 

Let's add the schematic symbols to the editor sheet. Use the BoM table from the introduc- 
tion chapter to help you find the required symbols. Add all symbols except for the headers. 
I plan to add the symbols in a second sheet in the next segment of this chapter. 

Download the files from Snapeda (all three types: symbols, footprints, and 3D models if 
available), and store them in your project folder. Install them as I describe in the relevant 
chapter from Part 7. You should be able to find all symbols in KiCad's symbol libraries, 
except for those for the microcontroller’ ("U4") and the real-time clock* ("U2"). I installed 
these libraries in my Project Specific Libraries tab: 


7 https://www.snapeda.com/parts/ATMEGA328P-AU/Microchip%20Technology/view- 
part/?ref=search&t=atmega328P-AU 
8 https://www.snapeda.com/parts/DS1337S/Maxim%20Integrated/view-part/?ref=search&t=DS1337S 
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ee Symbol Libraries 
Libraries by Scope 


Global Libraries Project Specific Libraries 


Active Nickname Library Path Library Format Options Description 
ATMEGA328P-AU S{KIPRIMOL Legacy 


+e Tt 4 cj Migrate Libraries 


Path Substitutions: 


${KICAD6_SYMBOL_DIR} /Volumes/RAID/Kicad Projects/Library/kicad/libeary/ 
S{KIPRIMOD} /Users/peter/Documents/Kicad/Course development documents/KiCad Like a Pro 3e Projects/MCU Datalogger 


Cancel E 
Figure 11.3.2.1: Changes to the Installed external symbol libraries. 


After adding all symbols (except for the headers), your schematic editor sheet will look like 
this: 
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Figure 11.3.2.2: The first sheet of the schematic design. 


For the remaining symbols, the headers, you will create a second sheet. You will do this in 
the next segment of this chapter. 


11.3.3. Schema 2 - Sheet two 


To create a new sheet to contain the connector symbols, create a hierarchical sheet. Select 
the hierarchical sheet tool from the right toolbar, and type in an appropriate name for the 
sheet and its file. I called mine "Connectors" and "connectors.kicad_sch," respectively. 
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eee Sheet Properties 
Fields 
Name Value Show H Align V Align italic Bold ‘Text Size 
Sheet name Connectors Left Bottom 1,27 
sheet tie [eomectrdicedach w @ eh op 17 
+t Ney 5 
Style 
Border width: 0.0006 mm Border color: Background fill: 
Page number: 2 
Hierarchical path: MCU Datalogger/Connectors Cancel 


Figure 11.3.3.3: Creating a hierarchical sheet. 


Place the hierarchical sheet symbol on the lower-right side of the schematic: 
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Figure 11.3.3.4: The new hierarchical sheet symbol. 


Double click on the hierarchical sheet button to enter the new sheet in the editor. Add the 
final four symbols for the connectors. The connectors sheet will look like this: 
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Figure 11.3.3.5: The contents of the "Connectors" sheet. 


At this point, all the symbols are in the schematic editor. This is an excellent opportunity 
to capture the progress in the Git repository. Save your work with KiCad, and check the 
current status of the repository: 


% git status 
On branch main 
Changes not staged for commit: 
(use "git add <File>..." to update what will be committed) 
(use "git checkout —- <File>..." to discard changes in working directory) 


modified: MCU Datalogger.kicad_pro 
modified: MCU Datalogger.kicad_sch 


Untracked files: 
(use "git add <file>...» to include in what will be committed) 


Libraries/ 
connectors.kicad_sch 
sym—Lib-table 


no changes added to commit (use «git add» and/or «git commit —a») 
% 


Git reports that two tracked files have changed and a new directory («Libraries»), and 


three other files are not being tracked. Start tracking for the three new files, and commit 
the changes: 
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% git add. 
% git commit —am "Have added required symbols to the schematic sheets." 
[main f488540] Have added required symbols to the schematic sheets. 
15 Files changed, 49834 insertions(+) 
create mode 100644 Libraries/3D/D81337S.STEP 
create mode 100644 Libraries/3D/atmega328p—au.stp 
create mode 100644 Libraries/ATMEGA3Z8P—AU/ATMEGA3Z8P-AU. Lib 
create mode 100644 Libraries/ATMEGA328P-AU/ATMEGA3Z8P—AU. step 
create mode 100644 Libraries/ATMEGA328P-AU/QFP80P900X900X1Z0-3ZN.kicad_mod 
create mode 100644 Libraries/ATMEGA328P-AU/how-to-import. htm 
create mode 100644 Libraries/ATMega328P-edited.kicad_sym 
create mode 100644 Libraries/DS1337S_/D51337S_.lib 
create mode 100644 Libraries/DS1337S_/D51337S_.step 
create mode 100644 Libraries/DS1337S_/SOIC127P600X175-8N.kicad_mod 
create mode 100644 Libraries/DS1337S_/how-—to—import.htm 
create mode 100644 connectors.kicad_sch 
create mode 100644 sym-lib-table 


Use «git status» to confirm that there are no pending commits. 


11.3.4. Schema 3 - Arrange, Annotate 
In this segment, you will arrange the symbols on the sheet to prepare them for wiring in 
step four. After that, you'll use the automated annotator to set identifiers for each symbol. 
I will arrange the symbols according to functional groups: 
1. The microcontroller and power group. 
The real-time clock group. 
The EEPROM group. 
The mounting holes group. 
The connectors. 


Te o 


Below is the final arrangement of the symbols in the root sheet before the automatic an- 
notation: 
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Figure 11.3.4.6: Final arrangement of symbols in the root sheet. 


Bring up the annotator tool, and using the default settings, annotate the schematic. The 


result is below: 


Cananea 
O rnga 
O Karene 
o ceda 


o: 
Pie cearta. ticadach Masringhoe 


Figure 11.3.4.7: Annotated symbols in the root sheet. 


This is an opportunity to commit the change to the Git repository. Here is my session on 


the command line: 


% git status 
On branch main 
Changes not staged for commit: 


(use "git add <file>..." to update what will be committed) 
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(use "git checkout —- <file>..." to discard changes in working directory) 
8 


modified: MCU Datalogger.kicad_sch 
modified: connectors.kicad_sch 


no changes added to commit (use «git add» and/or "git commit —a») 
% git commit —am "Changed locations of symbols (arrange)." 
[main 41550e3] Changed locations of symbols (arrange). 

2 files changed, 215 insertions(+), 215 deletions(-) 


With the change committed, you can continue with the next step of the project, adding the 
component values. 


11.3.5. Edit component values 
In this chapter segment, you will add the values for components such as the capacitors and 
the resistors. Use the information in the BOM table in the introduction of this project as a 
source. You can use one of these methods to edit the component values: 
1. Open each symbol's Properties window (double-click on a symbol), and type the 
value in the Value field, as in the example below: 


1 


T i Ri i lo. E 
30K 10K i 4 


eee Symbol Properties 


General Alternate Pin Assignments 


Fields 

Name Value Show HAlign  VAlign Italic Bold Text Size 

eference Center Center 1.27 

Center Center 127 

Center Center 1.27 

Datasheet ~ Center Center 1.27 

Purpose Center Center 1.27 

Wikipedia URL Center Center 1.27 


ad Uy BL ē 
insa pas Update Symbol from Library... 
Unit Show pin numbers an 
Alternate symbal (DeMorgan) © Show pin names ei do diia 
Edit Symbol... 
Angle: +90 B Attributes 
Mirror: Not mirrored Exclude from bill of materials — 
hess 
dation board Edit Library Symbol 
Library link: Device:C Spice Model... Cancel OK 


Figure 11.3.5.8: Editing the value field of a symbol. 


e 36 


Part 11 : Project - MCU datalogger 


2. Edit the symbol value fields in bulk using the Symbol Fields Table. Click on the Fields 
Table button from the top toolbar to open the table window, as in the example be- 
low: 


AD Hew TAQAQQHE’ &sPA RAG PRSEG SS 


T Header 2 54mm Pet 
apacner SWOL D805 DNA 


jowrting Hole: MoaniingHeie_? 1mm 
oneni FrHead 2 54mm PieHeoder 10G_PZ5Amm_ Vertical - a 
'ormecto,_PrHeader_2.54mm PleHeoder_1:08_92,54mm_Yortical 
ommecto! PrHcader_2 iamm PisHeoder_2603_P2. 54mm Varea) tose 
esistor_SMD:R_0805_J012Metre 
'cistor_SM0:A_0805_2012Motro 
esistor_SMD-A_0805_2012Metrio 

eters SOCIIIPECON 1750 
A] hp odas comdonricada e Devica Doc 210818 pl 
poterinieQOPADPDOCKOOK 120-220 

ynial Cryst SAD SO3Z-2P 8 Ck Beard bg 
yatad Erwin SMD S0%9-2P AOs imm _Hindsukiorirg 


E 
3 
ss esca f 


Aga fiai 


Atoiy. Seve Schematic & Contos Cocet | GD 


Figure 11.3.5.9: Editing the value field of all symbols using the Symbol Fields Table. 


By the end of this process, the values for each of the symbols in the schematic should look 
like those in Figure 11.3.5.9. 
Let's update the Git repository: 


% git status 
On branch main 
Changes not staged For commit: 
(use "git add <Fil e>..." to update what will be committed) 
(use "git checkout —- <file>..." to discard changes in working directory) 


modified: MCU Datalogger.kicad_sch 


no changes added to commit (use «git add» and/or "git commit —a») 
% git commit -am "Added component values." 
[main Z90fba6] Added component values. 

1 file changed, 28 insertions(+), 28 deletions(-) 


Let's continue with the «Associate «part of Step 3 of the schematic workflow. 


11.3.6. Schema 3 - Associate 
In this step, you will associate the symbols with their footprint counterparts. As with the 
editing of the values that you finished in the previous segment, you can choose to associate 
symbols with footprints in two ways: 

1. By editing the Footprint field in the symbol's Properties window. 

2. By doing the associations in bulk, using the "associations" tool. 
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Since there are several symbols to work with, I suggest that you use the bulk option. Draw 
from the information present in the BOM table in the introductory chapter. The "Footprint" 
column contains the name of the footprint to look for in the footprints library. 

Open the Assign Footprints window by clicking on the "associations" button in the top tool- 
bar. The middle pane of the window contains the current associations and will be mostly 
blank (see below). 


Pa CQAQQRQQE Sara ORG Reams wm 
eee Assign Footprints 
Bae» OO opinen e o 
Libraries. H Filtered Footprints 
11825967-1 1 MAZI-IRASOG-S 1-13 1 ANT_AMCADL-2MS00-SLF-T3 
ASI ADOOS IIA 2 a= en A 2 Battery:Buttørynslder_Bulyin maose tac 
10 Module 3 a nage 3 Untrery:BotteryMolder_Contortabletlectro1c_0073-25 
a a IF + 4 Battery:BatteryHolder_Eagle 126611 
0) 5 cè ew = 3 Dattery:tatteryHolser Keystone 20) 11200 
iton Svitrh SHD s cs wor i 6 Battery:BatteryHelder_Keystone_104_1i23en 
yeian_Seiteh THT ? `- LM s 7 RetterycBatteryHelder Keystone 305 140248 
izzer_Deeper 8 oz - Laps teryiGatteryHelaer_Keystone_106_1s200e 
Librarian Seate » m Mountingtole 2 Y Battery:Bat teryHelder Keystone _287_1123am 
'apacitor so we Mountingito le + y 
'apacitor_Tantalun SMO n n3 Mount ingen Ve eryiBat teryWelder_Keystime_2B42_ 1418858 
pa iter TT n Hé Mount angio le UU Bat terystlat terytelder Keys tune JASA 122632 
‘omector v J1- Conn Seaain + LF BetteryiMatteryHelser Keystone IMA, 112032 
mector MASS m n Con eroale UU Battery: BatteryMoldes Keystone 7460 LAL 
'emectorAnghenal i5 33- Conn 01284 pads 18 Matter: Battery Les Koysionn_ 246? PxA 
umector Awie 16 34 ~ Com Alwe) Odd Even 16 DetteryiDatteryMolder Keystone 2405 1AA 
omaector_Barrellach v m 10 1) Bsttery:hatteryhslöet Keystone 2863 IxAra 
omector Card » R- 10 VA Dattery:Batterytislder Keystone 287% IAA 
omector_Ceaxial 29 LEJ ame 19 BotteryeBatteryhelder_Keystove_2996_1x6.den 
omectnr DIN i» M- 4m = 20 fut tery:tlatteryHolder Keys tinue 1000 1x1 2e0 
¡omector_Prub a 5- 3m 21 Battery Bot teryHolser_Keystove_J001_lxl2ee 
omector_FECAPC n mM - ims 22 Batteryitatteryheleer_Keys tose _3082_ 142832 
omector Merwin 2 v- om: 23 Rat terystat teryttelder Keystone 3000 _1x2450 
ormmector_HOMT 3 u MALICIA + 24 Battery :Botteryhelder_Keystone_3000_ 12450 
armector Hirose » or ©S12375+ : SOLCI27PAD0K175-AH DA Dat tery:Batterytelder_Meystime JA34 120s 
'onmector IOC 20 w- DAL + 26 BotteryiWotteryHolder LINK BAT-HLD-012-5MT 
'omectór ME 7 ue ATMEGAJZEP=AL 1 OFPERPORORIONKL2O-22N 27 Battery: BotreryHolder_MPD_BAGUPC_14PP3 
omector JST aw n- 32.700 Pu + 28 Detteryslatteryio Loss MPO DCAC 2A 
'omector_Molex 29 n- Le r i 29 Hotteryifatteryhlder_MPO_BOIZAAPC_ ZAA 
ctor Multiconpe 
Fiterod by Pin Count (2), Library: 2228 
Library Soc ation: unknown 
Aaply, Save Schematic & Continue Coc = 


Figure 11.3.6.10: Staring to set the symbol-footprint associations. 


Follow the process you learned earlier in this book to associate each symbol with a foot- 
print. You can find the footprint names in the BoM table in the introduction. The final Assign 
Footprints window should look like this: 


eee 

a@e+5 
Connector Saates MLE THT 
connector _SATA_SAS 
[Conmectar Stocks 
|Cnrmectur,_Te-Cennectivity 
lconnector_uso 
[Consector ago 


Koneactor Wire 
|Cormector_Meerth 


Mattery | Cannmctor_Psrteoger_2. Séew1Pisfender_Ix87_F2.34e5_Vert ical 
@.1uF 1 Capacitor s40sC_#085_2012Metric 
oF : Capacitar SMD:C_0005_J012Metrác 


Xip? + Capacitor 0:6 _4003_2012Metric 

4. 1uF | Cmpacitor_SMO:C_0005_2012Metric 

AWE : Capacitor_5M0:C_6805_301Motri£ 
LED : LEO_SPO:LLO_ woud 20D AC 
LED | LED_SMOILED_P005_2012etrác 


[converter_AcDc Meuntirguole : Maunt Ingo le: Maust logro le_2, ina 
[Conmnrtar_DCDE Mauntirgiele : Punt ingmole:Mauet ingle 2. Le 

crystal Mountinghele 1 Mount ingin lerrountingmo le? Une 

[besktosLibrary - — Meuntimgiele 1 MountingoLe/Mouet inge Le_2, ie 

|dspahiry-Footnrinty - Conn Wixi Male ; Comector Pirtaater 2.5éePintasder 1204 PL. mn Vertical 
bodu HD. — Conn Madh Malo 1 Convector, Pirteader 2, Séew:Pistonder, 1109_P2. Sian Vert icrt 
bose TNT ~ Conn OD Mele : Comector_Pirtteador_2, SéemiPintonder 1x04 P2.t4e_Verticat 
isotay - Com #243 008 Evan : Comoctor_Pireuador_2.54em:Pistaader_2x03_P2. Sdan Verticò 
isoler Sopra 10% + Rusietar 0:7 PIUS IPINtriE 

Ferrite net 10% ; Resistor POIR MaS AMMetric 

Fide Lat - AN 1 Resistor POR tas POLE Le 

Piltar - 4.7K : Aasistar MOR ands, 21m rd 

footprints 320 | Resistor WOR MUS 20 Met rie 

Fuse - 10K 1 Resistor SOIR BAS 2LMetric 

[heatsink - 330: Resistor_D0:A_0895_ 2002etrie 

ribet 9 JALCIOLS ; Pochoge_$0=501C-4_S, 219.230 M1. 2Tew 

[Indectar_TNT D513375+ 1 Footprints:S0IC1Z7P608K175-84 

|Jumpar - JALCIAOS | Paciimo_SO:S0IC-8_5.23x5.2308_P1.2 108 

oso PEGA TIPA + OPIO I-J 

[Leo_THr 32.708 Mtz i CryntalsCrystal_SMO_9032-2Pan_5. 0x3. 2em_MunsSotdering 
ps n- 16 Púa 1 CoyataliCrystal_SMD_SO02-2P4n 5. 6x3, Dn Mando lero 

ing erate 


Fiherod by Pin Count (32), Library (Footprints)! 
Señamatic savad 
Library Weation: (Likers/iotd/CocumintyKicad/Course development docena Cad Like a Pro de Arojecta/MCU Dutatoggul trar Fostpínte 

Apoth Save Schematic & Continue. y cence MC 


Figure 11.3.6.11: The final symbol-footprint associations. 
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Let's complete this step by committing the changes to the Git repository: 


% git status 
On branch main 
Changes not staged for commit: 
(use "git add/rm <file>..." to update what will be committed) 
(use "git checkout -- <file>..." to discard changes in working directory) 


deleted: Libraries/ATMEGA3Z8P-AU/QFP80P900X900X120-3ZN.kicad_mod 
deleted: Libraries/ATMega3Z8P-edited.kicad_sym 

deleted: Libraries/D51337S_/SOIC127P600X175-8N.kicad_mod 
modified: MCU Datalogger.kicad_prl 

modified: MCU Datalogger.kicad_pro 

modified: MCU Datalogger.kicad_sch 

modified: connectors.kicad_sch 


Untracked files: 
(use «git add <file>...» to include in what will be committed) 


Libraries/Footprints/ 
fp-lib-table 
no changes added to commit (use «git add» and/or «git commit —a») 
% git add . 
% git commit -am "Completed symbol-footprint associations." 
[main d52702e] Completed symbol—Footprint associations. 
8 files changed, 158 insertions(+), 64 deletions (-) 
rename Libraries/{ => Footprints)/ATMega328P-edited.kicad_sym (100%) 
rename Libraries/fATMEGA328P-AU => Footprints}/QFP80P900X900X120—32N.kicad_mod 
(100%) 
rename Libraries/{DS1337S_ => Footprints}/SOIC127P600X17S-8N.kicad_mod (100%) 
create mode 100644 Fp-lib—table 


% 


Let's continue with the wiring, which is Step 4 in the schematic design workflow. 


11.3.7. Schema 4 - Wiring of sheet 1 

Because the schematic is broken into two sheets, I will do the wiring in two parts. First, 
I will wire the root schematic using a combination of graphical line wires and net labels. 
Then, I will connect the symbols in the Connectors sheet with those in the root sheet using 
hierarchical labels. 

To make the wiring process systematic, I will wire symbols that belong to the same func- 
tional group before continuing with other components. I will start with the real-time clock 
group. When the wiring is complete, this group looks like this: 
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Vec 


u2 
DS1337S+ 


ci 
O.1uF 


Yi SDA 
32.768 KHz 


GND GND 


Figure 11.3.7.12: Real-time clock group wiring is complete. 


Continue with the memory groups: 


vi U3 w 
24101025 24101025 
Vec Vec 
di D 
ve = tow Ls 
ee 4.7K 4.7K 
Vee 
sc 5D 
GND 


Figure 11.3.7.13: Memory group wiring is complete. 


Next, the microcontroller and power group: 
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us 
ATMEGA3S28P AU 


R? 
330 


Q PWR_FLAG 


Figure 11.3.7.14: MCU and power group wiring are complete. 


The wiring for the root sheet is complete. You can see it below: 


Camarin 
o: 
Mountinatvie 
ver 
us se 
us 
acros Mos ye © aiie 
oi 
Wee, SDA Ver, 504 a tie MountingNute 
dl are LJ are 
Vee i o! 
File: connector Mitad ach Moamingiese 


Figure 11.3.7.15: Root sheet wiring is complete. 


The second sheet remains to be wired, but this is an excellent opportunity to commit the 
changes to the Git repository: 
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% git status 
On branch main 


Changes not staged for commit: 
(use "git add <file>..." to update what will be committed) 
(use "git checkout — <file>..." to discard changes in working directory) 


modified: MCU Datalogger.kicad_sch 


no changes added to commit (use «git add» and/or «git commit -a») 


% git commit —am "Completed wiring of main sheet." 


[main e0392b3] Completed wiring of main sheet. 
1 file changed, 887 insertions(+), 70 deletions(-) 


Let's continue with the wiring of the Connectors sheet. 


11.3.8. Schema 4 - Wiring of sheet 2 
The wiring of the symbols in the Connectors sheet is pending. Let's complete it now. 


The Connectors sheet contains four connector symbols. The pins on those symbols must 
be connected to pins on symbols in the root sheet. For this reason, I will not be using any 
graphical line wires. Instead, I'll be using a combination of net labels and hierarchical sheet 


labels. 


Open the Connectors sheet by double-clicking on the hierarchical sheet symbol in the root 
sheet. To create a hierarchical label, click on the hierarchical label button in the right tool- 
bar. In the Properties window that appears, give the label a name, and set its properties 


(see example below). 


J1 J3 Root (pago 1) 
Soma ele Conn-01:04 Male e 
E, a + 
2, mk E 
me ma 1 
o D Hierarchical Label Properties A 
Label: GNo} a 
Text Size: 1.27 mm Syntax help + 
Justitication Ste Shape =3 
© 
input 
peste os O Output PR 
O Align test Bold somi B 
Align top Bold and italic anida 4 3 
Cancel IED 5_Odd_Even 33 
ae Zs a 
pci a . AR 
E a 
E 
— ICSP 


Figure 11.3.8.16: 
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Attach this label to J1 pin 1, like this: 


J3 
Conn.01304 Male 


— 


EG 


Serial UART 


Figure 11.3.8.17: Attaching a hierarchical label to J1 pin 1. 


Note that the symbol representing the hierarchical label depends on the Shape you chose 
in its Properties windows. The shape that you see in the example above represents an 
"output" label. As this pin is connected to the GND net, I will select the "passive" shape. 
Continue in the same way until you have created hierarchical labels for all pins in this sheet. 
Once completed, the Connectors sheet will look like this: 


J1 J3 
Conn_01x04_Male Conn_01x04_Male 
—Locnp —Locno 
—2ZoOVcc 2 OVec 
SDA —arx 
—*osck Lp Tx 
12C Serial UART 
J2 
Conn_01x09_Male 
—1t5p2 
2003 J4 
: D4 Conn_02x03_Odd_Even 
0 D5 4 2 
“Lo MISO 3 % Vec 
E SCK MOSI 
pais RESETOS GND 
=—— D8 
—So6np ICSP 
—Laovec 
GPIO 


Figure 11.3.8.18: Hierarchical labels attached to all pins. 


Save your work and open the root sheet. The hierarchical labels exist in the Connectors 
sheet. You will need to: 
1. Expose those labels to the root sheet. 
2. Connect the exposed hierarchical labels to other pins using either graphical line 
wires or net labels. 
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Use the "Add a hierarchical sheet (S)" tool from the right toolbar to complete step one. Click 
anywhere inside the hierarchical sheet box to drop one of the hierarchical labels and place it 
along the perimeter with the tool selected. You can see the first hierarchical label attached 
to the left of the box below: 


[Ey 

PWRFLAG AO 

ES 

GND No la 

y 

Connectofs T 

8 

e” M 
k $ Ha 


MountingHole 


H2 
MountingHole 


HS 
MountingHole 


H4 
MountingHole 


File: conhectars kicad_sch 


Figure 11.3.8.19: Exposing the hierarchical labels. 


Continue in the same manner to expose and place the remaining hierarchical labels. Here is 
the completed Connectors sheet symbol, with all hierarchical labels in their final positions: 


Connectors 
Vcc 
GND 
10 SDA D29 
LISCK D3 
D4 
ja TX = 
DRX i 
D7 o> 
{> MOSI Dgo 
K MISO 
E RESET 


File: connectors.kicad_sch 


Figure 11.3.8.20: The Connectors hierarchical sheet 
symbol with exposed hierarchical labels. 
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I have placed all labels that connect to a digital pin on the right side and the rest along the 
left side. 

The next step is to connect the hierarchical labels to their corresponding pins in the root 
sheet. In the example below, I have used a Vcc net label, a GND symbol, and graphical line 
wires to connect the Vcc and GND hierarchical labels to the local news: 


Connectors 
_— 

ET GND 

GND > SDA D2 
fOSCK D3 

D4 

9 TX 8 
DRX D70 
DMOSI nas 
I] MISO 
{1 RESET 


File: connectors.kicad_sch 


Figure 11.3.8.21: Connected the Vcc and GND hierarchical labels to local nets. 


Continue to complete the rest of the connections using net labels. The result of this work 
is below: 


Connectors 
es A 
GND 
GND eae SDA D2 o 
GSCK DIO 
D4 
D4 Ons 
Xa tx D5 p6 
RX D6 Q 
DRX D7 
D7 Ang 
MOSS mosi DBS 
MISO 
RESET MISO 
ORESET 


File: connectors.kicad_sch 


Figure 11.3.8.22: Completed connections of hierarchical labels to local nets. 
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At this point, the schematic is fully wired. In the next couple of segments, you will allocate 
nets to net classes, conduct an electrical rules check, and finish the schematic design work- 
flow by adding comments to the schematic. 


11.3.9. Schema 5 - Nets 
You completed most of the work relating to named nets during the wiring step, where you 
used net labels and hierarchical labels to complete the wiring. In this step of the workflow, 
you will: 

1. Cross-check all nets to ensure you haven't missed any. 

2. Assign nets to net classes. 


You can do the cross-checking visually and confirm that no nets remain unnamed. 
For the net to net class assignments, open the Net Classes tab under «Project» in the Sche- 
matic Setup window: 


e o Schematic Setup 
General Net Class Wire Thickness Bus Thickness Color Line Style 
Formatting Default 0.1524 mm 0.1524 mm eee Solid 
encon: 
Electrical Rules 0.1524 mm 0.1524 mm r= Solid 
Violation Severity 
Pin Conflicts Map 
Project 
‘Text Variables 
+ a Set color to transparent to use Kicad default color. 
Filter Nets Not Not Class 
Net class filter: e | a Default 
Net name filter: Default 
Default 
Show All Nets Apply Filters 


Default 
Detault 
Assign Net Class Default 

New net class: Default [3] Default 
Default 
Default 
Default 
Default 


Matase 


Assign To All Listed Nets Assign To Selected Nets 


Import Settings from Another Project... 


Figure 11.3.9.23: Allocating nets to net classes. 
During the setup step of the workflow, you created the Power net class. Use the net table 


on the right side of the window (above) and the «Assign Net Class» widgets (middle-bottom 
of the window above) to allocate the Vcc and GND nets to the Power net class. 
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ee Schematic Setup 
General Net Class Wire Thickness Bus Thickness: Color Line Style 
Formatting Default 0.1524 mm 0,1524 mm mes Solid 
Field Name Templates GRAN O pa 
Electrical Rules Power 0.1524 mm 0.1524 mm es Solid 
Violation Saverity 
Pin Conflicts Map 
Project 
Text Variabl 
a laa + a Set color to transparent to use Kicad default color. 
Filter Nets Net Net Class 
Net class filter: /MOS! Default 
Net name filter: /RESET Default 
¡RX Default 
Fi 
Show All Nets Apply Filters ¡SCK Default 
JSDA Default 
Assign Net Ciass ITX Default 
peinar oian: foe Power 
C | 
Assign To All Listed Nets Assign To Selected Nets 
k Net-(R2-Pad2) Default 
Net-(R5-Pad2) Default 
Net-(R7-Pad1) Default 
Import Settings from Another Project... Cancel Wa 


Figure 11.3.9.24: Allocated Vcc and GND nets to the Power net class. 


In the figure above, I have selected the Vcc and GND nets in the nets table on the right side 
and assigned them to the Power net class using the widgets on the left side. All other nets 
can remain in the Default net class. 

You can create additional net classes if you wish, such as one for the digital pin nets and 
another one for the communications nets. For this demonstration project, I will continue 
with the two net classes you can see in Figure 11.3.9.24. 

Save your work. 


The work in this step of the workflow is complete, so time for a new commit to the Git 
repository: 


% git status 
On branch main 
Changes not staged for commit: 
(use "git add <file>..." to update what will be committed) 
(use "git checkout — <file>..." to discard changes in working directory) 


modified: MCU Datalogger.kicad_pro 


no changes added to commit (use «git add" and/or «git commit -a») 

% git commit -am "Allocated GND and Vcc nets to the Power net class." 
[main c23c884] Allocated GND and Vcc nets to the Power net class. 

1 File changed, 4 insertions(+), 1 deletion(-) 


% 


Continue with a final ERC in the next segment of this chapter. 
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11.3.10. Schema 6 - Electrical Rules Check 

This final ERC should not reveal any defects if you have been careful with your work during 
the schematic design workflow. Nevertheless, always do an ERC before starting work on 
the layout design. 

Open the ERC window, and run the check. Mine revealed only one minor issue: 


us 
ATMEGA325P-AU 
PWR_FLAG 


u2 
DS13375+ 


sel 
x 
e o Electrical Rules Checker 


Messages Violations 


~ Symbol 'ATMEGA328P-AU' has been modified in library 'ATMEGA328P-AU'. 
Symbol U4 [ATMEGA328P-AU] 


Show: All Otros E) pE Warnings En Exclusions Save... 0293 


Delete Markers Close Run ERC D5003 


Figure 11.3.10.25: The ERC shows one warning. 


The single ERC warning relates to a modification that I made to the Atmega328P-AU sym- 
bol. It is warning me that the symbol I use in the schematic is different from the one stored 
in the library. That is not something that concerns me for this project, so I will safely ignore 
this warning. 

A Git status check shows no change in the project, so there is no need to do a new commit. 
Let's complete the work in the schematic design workflow in the next segment by adding 
comments to the schematic. 


11.3.11. Schema 7 - Comments 
To complete work in the schematic design workflow, you will add simple graphics (boxes) 
and text. Here is a list of comment items I have added to my schematic: 
e Use lines to box-in symbols that belong in the same functional group: 
- Real-time clock. 
- MCU. 
- EEPROM. 
- Mounting holes. 
- Connectors. 
e Use text labels to give a name to each functional group. 
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Below you can see the two sheets, with my comments: 
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Figure 11.3.11.26: Root sheet with comments. 
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Figure 11.3.11.27: Connectors sheet with comments. 


This completes all work in the schematic design workflow. Save the changes, and commit 
to Git: 
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% git status 
On branch main 
Changes not staged for commit: 
(use "git add <file>..." to update what will be committed) 
(use "git checkout — <file>..." to discard changes in working directory) 


modified: MCU Datalogger.kicad_sch 


no changes added to commit (use «git add» and/or «git commit -a») 
% git commit —am "Completed comments." 
[main 8fdlab7] Completed comments. 

1 file changed, 151 insertions(+), 70 deletions(-) 


In the next chapter, you will begin work on a two-layer version of the layout design. In a 
later chapter in this project, you will also create a four-layer layout. To keep the two layouts 
separate, you will create dedicated Git branches. 

So, before starting work on the two-layer layout, you will create the two-layer Git branch. 
Let's do that in the next chapter. 


11.4. Create the 2-layer branch in Git 

KiCad cannot support multiple layouts for a schematic. However, this is something that 
becomes possible with the use of Git. In this project, one of the objectives is to design two 
versions of the layout: a two-layer PCB and a four-layer PCB. Since KiCad can only "see" 
one layout file, you will create a dedicated Git branch for each layout version. 

In this chapter, you will create a new branch for the two-layer PCB. Later in this project, 
you will create a separate branch for the four-layer PCB. 

Ensure that you are working in the main branch (use "git branch" for this). Then, create a 
new branch named "2layer" and switch into it. You can do both in a single command, like 
this: 


% git checkout -b 2layer 
M MCU Datalogger.kicad_pro 
Switched to a new branch '2layer' 


% 


Check the status of the repository to confirm that its contents are clean, meaning that it 
matches with the contents of the main branch from where the new branch stems: 


% git status 
On branch 2layer 
nothing to commit, working tree clean 


% 


The new branch is clean, and there are no changes to commit. 
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Finally, use the «branch» command to get a list of branches in the repository: 


% git branch 
x 2layer 
main 


The repository now contains two branches. The active branch is «2layer». You will continue 
to commit changes to this layer for all work I describe in the next chapter. 
An important question to ask here is how to deal with changes to the schematic? You can 
answer this question in several ways, but I will describe my tested and simplified process 
below. 
If you are working on the layout of a PCB in a dedicated branch, and you need to make a 
change to the schematic, follow this process: 

1. Commit any changes to the layout branch. 

2. Switch to the main branch, which contains the authoritative version of the sche- 

matic. 

. Make the necessary changes to the schematic, and save the sheet. 
. Commit the changes to the main branch. 
. Switch to the layout branch. 
. Merge the main branch into the layout branch. 
. Continue work in KiCad and import schematic changes into the layout editor. 


NOW A uy 


You can learn how to merge changes between branches in the Git chapter in the Recipes 
part of this book. 

Now that you have created the two-layer Git branch, you can continue with the layout 
workflow in the next chapter. 


11.5. Layout design 

In this chapter you will work on the layout design of the two-layer version of the PCB. You 
will be working in the "2layer" branch of the project Git repository that you created in the 
previous chapter. 

Let's begin by setting up the layout design editor. 


11.5.1. Layout 1 - Setup 
Open Pcbnew, and confirm the editor settings. In the bullet list below, I show any non-de- 
fault configuration I have applied in my project instance. 
e KiCad Preferences. 
- PCB Editor. 
- Display Options. 
- Min grid spacing: 15 px. 
e Board Setup. 
- Board Stackup. 
- Physical Stackup. 
- Copper layers: 2 
- Board Editor Layers. 
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- F.Cu: mixed. 
- B.Cu: mixed. 
- Text & Graphics. 
- Text Variables: "project_name" variable inherited from Eeschema. 
- Net Classes. 
- Power. 
- Clearance: 0.25 mm 
- Track Width: 0.35 mm 
- Via Size: 0.9 mm 
e Page Settings. 
- Issue Date: copy today's date. 
- Revision: 1 
- Title: ${project_name} 
- Commentl: 2-layer PCB version. 


Save the setup changes, and then update the PCB from the schematic. 
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Figure 11.5.1.1: Updated PCB from the schematic. 


Save the changes in the layout editor, and commit them to the Git repository. You can see 
my command line session below: 


% git status 
On branch 2layer 
Changes not staged for commit: 
(use "git add <file>..." to update what will be committed) 
(use "git checkout -- <file>..." to discard changes in working directory) 


modified: MCU Datalogger.kicad_pcb 
modified: MCU Datalogger.kicad_pro 
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no changes added to commit (use «git add» and/or «git commit —a») 
% git commit -am "Setup Pcbnew." 

[2layer 1163ble] Setup Pcbnew. 

2 Files changed, 1028 insertions(+), 1028 deletions(-) 


% 


Continue with step two of the layout design workflow, where you will draw the rough out- 
line. 


11.5.2. Layout 2 - Outline and constraints 
I will follow the same process as in the previous projects, where I first draw a rough outline 
for the PCB. I will re-draw the final, refined outline once I have placed all footprints within 
the rough outline. 
For the rough outline, I am about to draw, I have listed the following constraints: 

1. The outline should be large enough to accommodate all footprints. 

2. The outline should be as small as possible to minimize manufacturing costs. 

3. The outline should be rectangular, with four mounting holes at its edges, to make it 

easy to fit inside a project box. 
4. The headers should be along the edges of the PCB to make them easier to access. 


I start by evaluating the total dimensions of the footprints, as they appear in the editor 
after importing them from Eeschema. You can see the footprints bundled together below: 
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Figure 11.5.2.2: I will create a rough outline for the bundled footprints. 


Enable the Edge.Cuts layer and switch the grid size to 1.27 mm. I used the measuring tool 
to measure the width and height of the footprint bundle. For the width, I measured approx- 
imately 50 mm, and for the height, around 30 mm. This gives me enough information to 
draw a rectangle that can accommodate the footprints. 
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Use the rectangle drawing tool from the right toolbar, and draw a rectangle. Based on my 
selected grid size, my rough outline measures 50.800 mm x 30.480 mm. 
You can see the result below: 


AWOB\N YB 


Se @ 4 


Figure 11.5.2.3: Drawn a rough outline of the board. 


The footprints should fit comfortably in this outline. Let's continue in the next segment, 
where you will place the footprint within the board outline. 


11.5.3. Layout 3 - Place components 

The rough outline you created in the previous segment will make it easier to place the foot- 
prints within it. Compared to the LED matrix display PCB, the footprint placement step in 
this project is much easier. No external constraints dictate the exact position of footprints. 
I have followed a simple process to help me with the placement, which I outline below: 

1. Change the grid size to 0.635 mm. This will provide a fine grid to allow for precision 

spacemen with minimal wasted space. 

2. Place the microcontroller footprint in the middle of the board. This will make it 
easier to connect it to the various peripherals and connectors around it (except for 
the power connector). 

Place the mounting holes in the four edges of the outline. 

Place the connectors along the bottom and right edges. 

Place the EEPROM and real-time clock footprints on the left of the MCU. 

Place the oscillator for the real-time clock on the left of the RTC footprint. 

Place the oscillator for the MCU below the MCU footprint. 

Place the battery connector on the left edge of the outline. 

Place the capacitors in the remaining space; make an effort to minimize their dis- 

tance to their main components using the ratsnest lines as a guide. For example, 

C1 should be next to U3 and C2 near Y2 to minimize their total copper track widths. 

10. Place the resistors last, as close as possible to their main components. Again, try to 
minimize their copper track lengths using their ratsnest lines as a guide. 

11. Use the editor alignment tools to ensure that all footprints are correctly aligned. 


0. 2 SOY 012 O 


You can see my final placements below. Your's may differ, of course, but the figure below 
gives you an example. 
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Figure 11.5.3.4: The final placement of the footprints in the rough board outline. 
Save your work, and commit the changes to the Git repository: 


% git commit -am "Completed placement of footprints." 
[2layer 9fe697f] Completed placement of footprints. 
2 files changed, 76 insertions(+), 74 deletions(-) 


With the footprint placement complete, you can continue and refine the board outline. 


11.5.4. Layout 2 - Outline refinement 
The rough outline of the board helped you to place the footprints within its borders. With 
the footprints now placed, you can refine this outline and complete the drawing in the Edge. 
Cuts layer. 
Looking at the result of the last two steps of the process (below), you can see that it is 
possible to reduce the size of the board further by: 

1. Reducing the gap between the outer footprints and the outline edges. 

2. Placing the mounting holes in outdents in the four corners of the board. 

3. In the figure below, I have super-imposed the rough outline of the board with the 

refined version so that you can see the differences: 
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Figure 11.5.4.5: Comparing the rough board outline against the refined version. 


You can create the circular segments of the board using the arc tool. The placement of the 
mounting holes within the outdents makes it possible to (carefully) snap them off the board 
if you don't want to use them so that the board can fit in a smaller box. 

Below you can see a larger version of the refined outline: 
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Figure 11.5.4.6: The final refined board outline. 
Save the changes and commit them to the Git repository: 


% git status 
On branch 2layer 
Changes not staged for commit: 
(use "git add <file>..." to update what will be committed) 
(use "git checkout — <file>..." to discard changes in working directory) 


modified: MCU Datalogger.kicad_pcb 


no changes added to commit (use «git add» and/or «git commit -a») 
% git commit -am "Refined and completed outline 
[2layer 9d8b9cd] Refined and completed outline. 

1 File changed, 14 insertions(+), 7 deletions (-) 


In the next step of the layout workflow, you will do the routing of the copper tracks on the 
top and bottom layers. 


11.5.5. Layout 4 - Route 

The manual routing of a board is usually the most time-consuming step of the layout work- 
flow. It took me approximately one hour to route this board into two layers. This time in- 
cludes several cases of undoing work that I had already completed to improve and optimize 
the placement of tracks. 

For the entire routing process, I used the Interactive Router in "Walk around" mode. 

Here is an outline of the strategy that I followed: 
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1. General rule #1: Draw signal and Vcc tracks in the top copper layer. 

2. General rule #2: Use a copper fill connected to the GND net to connect all THT pads 
that belong to the GND net. Therefore, leave THT GND pads unconnected until the 
copper fills step (in the next segment in this chapter). You may follow the same rule 
for the Vcc pads and use a copper fill in the top layer connected to the Vcc net to 
route them. 

3. General rule #3: Minimise the space between tracks to reduce unusable space. In 
the example below, I have placed the red tracks at minimum distances from each 
other ("1"), leaving enough space for at least one more track ("2"). 


UZS 


Figure 11.5.5.7: Don't waste space. 


4. General rule #4: Exhaust your search for a path for a non-GND track in the top layer 
before using vias. In many cases, you will be able to complete these tracks in the top 
layer simply by repositioning existing tracks. 

5. General rule #5: For SMD pads that belong to the GND net are not close to other 
GND pads, you can create a nearby via and connect it to the bottom layer copper fill. 
You can see an example of this below: 
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Figure 11.5.5.8: Using nearby vias to connect SMD GND 
pads to the GND copper fill in the bottom layer. 


6. Start by drawing copper routes between adjoining pads. This includes Vcc and GND 


00 


10. 


pads for the capacitors and resistors. Because most footprints in this PCB are SMD, 
I have drawn GND copper tracks in the top layer and used vias to connect them to 
the GND copper fill in the bottom layer. Here are a few example tracks that connect 
adjoining pads: 
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Figure 11.5.5.9: Tracks connecting adjoining pads. 


. Continue by drawing tracks that connect the peripherals to the central MCU footprint. 
. Draw the tracks to/from the connectors. 
. Create a copper fill in the bottom layer and connect it to the GND net. This should 


complete the routing for all THT pads and vias that belong to the GND net (I'll do this 
in the next segment of this chapter). 

Create a copper fill in the top layer and connect it to the Vcc net (I'll do this in the 
next segment of this chapter). 


After following this strategy, I produce this partially-routed layout: 
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Figure 11.5.5.10: Partially routed PCB; GND pads not connected yet. 


The missing tracks are those that complete the connections between the GND pads. My 
DRC check looks like this: 


e o DRC Control 


© Refill all zones before performing DRC Test for parity between PCB and schematic 
Report all errors for each track 


Violations (10)  Unconnected Items (19) Schematic Parity (0) 


Warning: Via is not connected or connected on only one layer 
Via [GND] on F.Cu - B.Cu 

Warning: Via is r&t connected or connected on only one layer 
Via [GND] on F.Cu - B.Cu 

Warning: Via is not connected or connected on only one layer 
Via [GND] on F.Cu - B.Cu 

Warning: Via is not connected or connected on only one layer 
Via (GND) on F.Cu - B.Cu 

Warning; Vía is not connected or connected on only one layer 
Via [GND] on F.Cu - B.Cu 

Warning: Vía is not connected or connected on only one layer 
Via [GND] on F.Cu - B.Cu 

Warning: Silkscreen clipped by solder mask 
Reference 'R1' 
Pad 4 of U2 on F.Cu 

Warning: Silkscreen overiap 


Show: All Errors @ Warnings 10 Exclusions Save. 


Delate Marker Delete All Markers Close | Run ORC | 
Figure 11.5.5.11: DRC shows unconnected GND pads and vias. 


Indeed, the DRC shows that the only unconnected items are GND vias and pads. The "Un- 
connected Items" list also shows a couple of unconnected Vcc pads (not showing in the 
list of the figure above). I will take care of both issues in the next segment in this chapter. 
There are also possible improvements in the shape of some of the tracks. In particular, I will 
be changing the shape of a few tracks that contain 90-degree corners and optimizing the 
use of space. I will make those improvements after creating the copper fills. 
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Save your work, and commit the changes to the Git repository: 


% git status 
On branch 2layer 
Changes not staged for commit: 
(use "git add <File>..." to update what will be committed) 
(use "git checkout -- <file>..." to discard changes in working directory) 


modified: MCU Datalogger.kicad_pcb 
modified: MCU Datalogger.kicad_prl 


no changes added to commit (use «git add» and/or «git commit -a») 
% git commit -am "Routing sans GND Vcc complete." 
[2layer 56c8f14] Routing sans GND Vcc complete. 

2 files changed, 382 insertions(+), 13 deletions (-) 


Let's continue with the copper fills. 


11.5.6. Layout 4 - Copper fills 

In this step of the layout design workflow, you will create two copper fills. You will place the 
first copper fill in the bottom copper layer and connect it to the GND net. Place the second 
copper fill in the top copper layer and connect it to the Vcc net. After creating these copper 
fills, the remaining unconnected items violations that the DRC reported in the previous 
segment of this chapter should be resolved. 

Below is the Properties window for the first copper fill (bottom copper layer, connected to 
GND): 


... Copper Zone Properties 
Layor Nor 
M Fcu ©) Hide auto-generated net names Sort nets by pad count 
10 Msc 


General 
Zone nama: mm 
Zone priority level: y (es Minimum width: 0.254 mm Orientation: o deg 
Hatch width: 1.016 
Shape Pad connections: Tharmal reliets E) a; oa 
Hatch gap: 1524 mm 
Constrain outline to M, V and 45 degrees i 
as n Thermal relief gap: 0.508 men Smoothing : o 5 
Thermal relief spoke width: 0.508 mm a 
Outline display: Hatched 19) Smoothing amount: 0 S 
Remove islands: Always e 
Cornee smoothing: None 8 
Fillet radius: mm 
Export Settings to Other Zones Cancel OK 


Figure 11.5.6.12: Copper fill properties for the bottom layer. 
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If you need a reminder on drawing a copper fill, please read the relevant chapter in Part 8 
of this book. 

Go ahead and draw the copper fill in the bottom layer. 

For the copper fill in the top layer, I will be using a shortcut that can save a lot of time. 
Instead of drawing the new copper fill, I will duplicate it and connect it to the Vcc net. This 
way, the top, and bottom copper layers will have the same shape. I describe this technique 
below: 
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Figure 11.5.6.13: Duplicating a copper fill. 


First, ensure that "Zones" is enabled in the Selection filter ("1", above). 

Next, right-click on the border of the existing copper fill to bring up the context menu ("2") 
and click "Duplicate" ("3"). The new copper fill outline will appear attached to the cursor. 
Move the outline slightly outside the board so that the two copper fills don't overlap, and 
double-click on it to open its properties window. 

Change the Layer setting to "F.Cu" and the Net to "Vcc," as in the example below: 


o Copper Zone Properties 


O MFtu © Hide auto-generated net names Sort nets by pod court 


Zone name Clearance 0508 mn Fl type: Match pattern E 
Zone priority level; o < Minimum widi 0.254 ae Orientation: o deg 
Hatch wich: wow m 

Sape Pad connections; Thermal reter E) 
m 


Hatch gape 1.524 
Comstrain nulle to M, V and 48 degrees eae wee ee nsan 


ee Thermal rellet spoke with; 0.508 
Cutino display: Hitcrad 8 Smoothing amount: 0 


Rumoww islanda: Aways a 


33 


Smoothing effort: 0 


Comer smoothing: None a 


Fiber radun: mm 


Export Setonge to Other Zones Canon 


Figure 11.5.6.14: Copper fill properties for the top layer. 
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Click OK to close the Properties window and move the fill outline to overlap the bottom 


copper fill. See a detail of the two copper fills overlapping below: 


Figure 11.5.6.15: The two copper fills overlapping. 


Fill both copper fills using the "Fill All Zones" context menu: 


» Rotate Counterclockwise 
Da Rotate Clockwise 
52 Change Side / Flip 


4 Properties... 
D Create Corner 


/ Special Tools 


A Locking 


— 
| <= Convert 


ES V ow 


T Grouping 
>$ Cut 
[F] Copy 
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||] Paste 


Paste Special... 
[+] Duplicate 


T Delete 


Select All 
¿5 Zones > @ Fill Zone 
Net Tools > 


= Fill All Zones 


J% Untill Zone 


Q Zoom si 


Figure 11.5.6.16: Fill all copper fills. 
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The result of this work is below: 


0 


Figure 11.5.6.17: Top and bottom copper layers, filled. 


After creating the copper fills, you may see that one or more Vcc or GND pads remain un- 
connected. This is usually due to segments on the top or bottom layers being inaccessible 
by the copper fill; there is simply no gap that is large enough for the fill area to enter into 
those segments. 

In the figure above, I have used an arrow to highlight two pads and one via that remain 
unconnected. 

If this happens in your layout, you will need to change the position and shape of the exist- 
ing tracks and vias to increase the available space through which the copper fills may be 
able to reach the unconnected items. 

I had to spend an additional thirty minutes reworking the tracks to finally make the copper 
fills reach all Vcc and GND pads. The result is below: 
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Figure 11.5.6.18: Top and bottom copper layers, filled, completed. 
Save your work and commit changes to the Git repository: 


% git status 
On branch 2layer 
Changes not staged for commit: 
(use "git add <file>..." to update what will be committed) 


(use "git checkout -- <file>..." to discard changes in working directory) 
modified: MCU Datalogger.kicad_pcb 
modified: MCU Datalogger.kicad_prl 
modified: MCU Datalogger.kicad_pro 
Untracked files: 
(use «git add <file>...» to include in what will be committed) 
_autosave-MCU Datalogger.kicad_pcb 
no changes added to commit (use «git add» and/or «git commit -a») 
% git commit -am "Completed routing." 


[2layer 55d972c] Completed routing. 
3 files changed, 6765 insertions(+), 3 deletions(-) 
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There is one autosave untracked file, which you can ignore as autosave files do not need to 


be tracked. In the next segment, I will discuss some of the board's routing improvements 
that I made. 


11.5.7. Layout 4 - Routing improvements 
There is always scope for improvement. You can improve your board design in several 
ways. Below is my top-four list: 

1. Optimize the positioning of the footprints. 

2. Shorten the length of the copper tracks. 

3. Improve the shape of the board. 

4. Improve the shape of the tracks. 


Here, still working in step four of the layout workflow, I took some time to improve the 
shape of some of the tracks. The improvements that I made are: 


1. Replaced any 90-degree corners with 45-degree corners. See an example here: 


11.5.7.19: Removing 90-degree corners. 


2. Fixed stray track segments, like the one below: 


Before After 


Figure 11.5.7.20: Removing a stray track segment. 


3. Reduced the number of bends in a track, like in this example: 
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11.5.7.21: Reducing the twists and turns. 


At the end of this process, my board layout looks like this: 
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11.5.7.22: Board layout with optimized routing. 


You could certainly continue with the optimization process forever. However, this is not 
practical, so at some point, you should stop and continue to the next step of the workflow. 
Save your work and commit the changes to Git: 


% git commit -am "Refined routing complete." 


[2layer 477bb71] Refined routing complete. 
1 file changed, 1710 insertions(+), 1035 deletions (-) 
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Let's continue with the silkscreen. 


11.5.8. Layout 5 - Silkscreen 

In step 5 of the layout workflow, you will add text and graphics in the top and bottom 
silkscreen layers. Because you will be working specifically in the top and bottom silkscreen 
layers, you can make invisible any items that exist in layers, such as the front and back fab- 
rication layers. This will remove text clutter in the editor. For the same reason, change the 
mode of the filled zone dedication to "Show only zone boundaries" and reduce the intensity 
of the tracks. All this will help you focus on the silkscreen layers and content. 

I organize this work in the following parts: 

1. Place existing content (such as footprint values and references) in the correct layer 
and location. Use the bulk editing tools to standardize the size of this content. In 
the example below, I use the "Edit Text and Graphic Properties" window to reduce 
the size of all reference designators so they can fit in the available space: 


e- o Edit Text and Graphic Properties 
Scope Filters 
Reference designators Filter items by layer: E F.cu y 

Values 
Other footprint text items Filter items by parent reference designator: 
Footprint graphic items Filter items by parent footprint library id: 
PCB graphic items Only include selected items 
PCB text items 

Action 


O Set to specified values: 
Layer: -- leave unchanged -- | v © Visible 


Line thickness: -- leave unchanged -- mm 


Text width: 0.7 mm O italic 
Text height: 0.7 mm GS Keep upright 


Set to layer default values; 


Line Thickness Text Width Text Height Text Thickness Italic Upright 
Silk Layers 0.15 mm 1 mm 1 mm 0.15 mm 
Copper Layers 0.2 mm 1.5 mm 1.5 mm 0.3 mm 
Edge Cuts 0.1 mm 
Courtyards 0.05 mm 
Fab Layers 0.1 mm 1 mm 1 mm 0.15 mm 
Other Layers 0.15 mm 1mm 1 mm 0.15 mm 

Cancel 


d 


11.5.8.23: Reducing the size of the Reference Designators text. 


2. Look for any visible content that should be made invisible, and make it so. For 
example, there is no need to show the values for the mounting hole footprints. 
Uncheck their "visible" property in their Properties window. In the example below, 
I have done this for reference designator H2, which belongs to one of the mounting 
holes: 
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o a Footprint Text Properties 


Reference: | H2 


Locked 


Layer: O E Silkscreen 


Width: 0,7 Italic 

Height: 07 Justification: Center 
Thickness: 0.1 Orientation: 0 
Position X: 92.075 Mirrored 

Position Y: 99.67 Keep upright 


Footprint H2 (MountingHole), front side, rotated 0.0 deg 


Cancel 


11.5.8.24: Made H2 invisible. 


3. Look for content in a non-silkscreen layer containing essential information, and 
move it to a silkscreen layer. For example, the crystal oscillator footprints contain 
their operational frequency in one of the fabrication layers. I want to show this in- 
formation on the front silkscreen. Below, I use the text bulk edit tool to do this for 
all values that exist in the F.Fab layer: 


o e Edit Text and Graphic Properties 
Scope Filters 
Reference designators Filter items by layer: B F.Fab v 
Values 
Other footprint text Items Filter items by parent reference designator; 
Footprint graphic items Filter items by parent footprint library id: 
PCB graphic items Only include selected items 


PCB text items 


Action 


© Set to specified values: 


Layer: O F.Silkscreen 
Line thickness: -- leave unchanged -- mm 
Text width: 0.8 mm © Italic 
Text height: 0.8 mm © Keep upright 
Text thickness: od | mm 

L 
Set to layer default values: 

Line Thickness Text Width Text Heigħt Text Thickness Italic Upright 

Silk Layers 015mm 1mm 1mm 0.15 mm 
Copper Layers 0.2 mm 15 mm 15 mm 0.3 mm 
Edae Cuts 0,1 mm 
Courtyards 0.05 mm 
Fab Layers 01 mm 1mm 1mm 0.15 mm 
Other Layers 0.15 mm 1mm 1mm 0.15 mm 


Cancel 
11.5.8.25: Bulk edit values in the F.Fab layer. 
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4. Add new text labels to convey pins roles, input voltage, etc. In the example below, 
I'm creating a text label with the content "2". I will place this label over pin D2 in 
header J2: 


> Text Properties 
Text: 
2 
Locked 
ayor: O F.Silkscroon v 
aÉ wian 08 mm italic 
Height 08 mm Justification: Center 8 
Thickness: 10,14] mm Orientation: 0 o 
Position X: 135,382 mm Mirrored 
Position Y: 93.218 mm 
Cancel 


11.5.8.26: Creating a text label. 


6. Add other elements, such as the board name and version number, logos, etc. 


Below you can see the latest version of my board, with a few outstanding issues that 1 will 
address later: 


an 


Se: 7 8 GND VCC J3GNDVCC_RX TX 


ELLE our 


= 
z 
fo] 
o 
o 
> 
= 
a 
un 
x 
U 
un 
12 


OR 


a Le 


11.5.8.27: Making progress with the silkscreen elements. 
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And here is a 3D rendering of the front side of the board: 


ie [a y 
<pF 5100902 LED DITED 


34 [CSP = 


R7 330 R5330 


ATMEGA328P_a; 


11.5.8.28: A 3D render of the front of the board showing the silkscreen progress. 


The back and front silkscreen are not yet complete. The DRC shows several violations in- 
volving silkscreen elements ("silkscreen overlap") and clearance violations. I have also no- 
ticed a couple of text labels that I must make invisible (such as the value for the lower-left 
mounting hole footprint, see Figure 11.5.8.26). I will fix these issues in the next segment 
of this chapter since they require special attention. 

I have also noticed that pad one of the battery connector is not connected to the Vcc net. 
This reveals a bug in the schematic that the ERC was not able to pick. See below: 


Batter 


= A 


G 


11.5.8.29: Pad one should be connected to Vcc. 


To fix this problem, return to Eeschema, and add the Vcc net label to the wire that connects 
to the positive electrode of Bt1. See the example below: 
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BT1 
Battery 


11.5.8.30: Fixing a bug in the schematic. 


Save the schematic and return it to Pcbnew. Update the PCB from the schematic, and con- 
firm that the battery connector's pad one belongs to Vcc: 


11.5.8.31: Pad one is now connected to Vcc. 


This fix did not have any follow-on implications and did not introduce new problems. Re- 
member that the schematic now contains changes that will be committed to the "2layer" 
branch. You will need to merge this change to the main branch. 

Let's continue to the next segment to fix the remaining DRC violations. 


11.5.9. Layout 4 - Routing violations and complete silkscreen 

The work so far has left several DRC violations that 1 will fix now. There is one design de- 
fect, however, that the DRC did not find. This defect relates to the battery connector's pad 
one fix I made at the end of the previous segment (where I attached it to the Vcc net). 

I will work on the battery connector's pad one issue first and then clear the DRC violation. 
When I attached pad one of the battery connector to the Vcc net, KiCad did not automati- 
cally apply the Power net class track width to the tracks connected to pad one. I will need 
to do this manually. The track that comes out of pad one contains multiple segments, as 
you can see below: 
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[cun 
11.5.9.32: Vcc track from pad one of the battery connector. 


The fastest way to apply the Power class's track width to the entire track is to use the "Se- 
lect All Tracks in Net" option in the selected track context menu. Right-click anywhere on 
the track, and click on "Select All Tracks in Net" under "Select": 


En ÉS ©] 
Select >) 57 Fiter selected items... 
+ 
Up 7 Select/Expand Connection 


my Brost Tek EAT 


“Sy Drag (45 degree mode) 


A Drag (free angle) 
Filet Tracks * Refill all zones betore performing DRC 
+ Report all errors for each track 
© Rotate Counterciockwise 
Cy Rotate Clockwise Violations (13)  Unconna 
C) Change Side / Fip Error: Clearance violation (netciass ‘Pow 
: Track {/SCK] cn F.Cu, length 2:2697 mm 
Properties... 
4 SÈ Via [/Vee] on F.Cu - B.Cu 
at Error: Clearance violation (netclass ‘Powy 
E / Special Tools Track [/SCK] on F.Cu, length 0.4317 mm 
a Locking > Track {/Vco) on F.Cu, length 1.0324 mm 
=a? Error: Clearance violation (netciass ‘Pow 
“cy Convert > Track (I5CK] on F.Cu, fength 0.4317 mm 


11.5.9.33: Select all tracks in net. 


Then, right-click again on the track, and select Properties. In the Properties window, check 
the «Use net class widths» option, and click OK. 


a 5 Track £ Via Properties 

Common 

Net: /Vec Y 
Locked 

Tracks 
Start point X: ~~ mixed values -- mm Layer: -- mixed values — v 
Start point Y: -- mixed values -- mm 
End point X: ~~ mixed values — mm 
End point Y; -- mixed values -- mm 

Use net class widths 


11.5.9.34: Using net class widths for the Vcc track. 
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The Vcc track from pad one of the battery connector should now appear slightly wider than 
the rest of the tracks. In the example below, the two arrows point to the edited Vcc track 
and a track that belongs to the Default class net. 


11.5.9.35: Power nets are wider then default nets. 


I will now continue with the DRC violations. There are two types of violations that are out- 
standing: 

1. Clearance violations caused by Vcc net vias and tracks that are too close to other 
tracks. Remember that the Vcc track belongs to the Power net class and has in- 
creased clearance requirements. 

2. Silkscreen overlaps. In some cases, two silkscreen items overlap. These are easy 
to fix by moving one or both items so that they don't overlap. 


My process is one of step-by-step elimination. After running the DRC to get a fresh list of 
violations, I use the violations list as my to-do list. I work my way from the top of the list 
until all items are cleared. In the example below, the first item in the list indicates that a 
track is too close to a Vcc via: 


y ct e; 


O footers Fount 


V Rotik all zones before performing DAC y Test for parity between PCB and schematic. 
vV Report all orrors for sach track 


Violations (17) Uncannected Noms (0) — Sohamatic Parity (9) 


Error: Clearance violation (netclass "Power" clearance 0.2500 mm; actual 0.2455 mm) 
Track UTX} on B.Cu, length 1.0246 mm 

Track (Vcc) on B.Cu, length 18995 mm 

Error: Clearance violation (netelass "Power clearance 0,2800 mm; actual 0.2455 mm) 
Track (TX) on B.Cu, length 0,7561 mm 

Track (Vcc) on B.u, length 28998 mm 

Error: Clearance violation (netclass "Power clearance 0,2800 mm; actual 0.2455 mm) 
Track UTX} on B.Cu, length 0.6002 men 

Track (/Vorc} on 8.Cu, length 28995 mm 

Error: Clearance violation (netolass "Power" clearance 0.2500 mm; actual 0.2288 mm) 
Track [SCK] on F.Cu, lenath 2.2697 mm 

Via [oc] on FCu - B.Cu 

Error: Clearance violation (netclasa ‘Power’ clearance 0.2600 mm; actual 0.1496 mm) 
Track U/SCKI on F.Cu, length 0.4317 mm 

Track (¡Voc) on Foy, langih 1,0324 mm 

Error: Clearance violation (netclass ‘Power’ clearance 0.2600 mm; actual 0.1995 mm) 


Show v AN Y Ems @ vV Wamings 106 Y Exclusions Savo. 


Delete Marker Delete All Markers Closa Run ORC 


11.5.9.36: A typical clearance violation. 
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I will drag the red track towards the right, away from the Vcc via to clear this violation. 
When finished re-drawing, rerun the DRC to update the list. You should have one fewer 
violation. 

Continue in the same way until you get to zero unconnected items and violations. You can 
see my last DRC below, showing only nine schematic parity issues that I can safely ignore: 


User Comments 
Umer, Ecol 


> o DRC Control 


© Refill all zones before performing DRC Test for parity between PCB and schematic 
Report all errors for each track 


Violations (0) Unconnected Items {0} Schematic Parity (9) 


Warning: Pad missing net given by schematic (unconnected-(U4-Pad13)). 
Pad 13 of U4 on F.Cu 

Warning: Pad missing net given by schematic (unconnected-(U4-Pad14)). 
Pad 14 of U4 on F.Cu 

Warning: Pad missing nefyiven by schematic (unconnected-(U4-Pad19)). 
Pad 19 of U4 on F.Cu 

Warning: Pad missing net given by schematic (unconnected-(U4-Pad22)). 
Pad 22 of U4 on F.Cu 

Warning: Pad missing net given by schematic (unconnected-(U4-Pad23)). 
Pad 23 of U4 on F.Cu 

Warning: Pad missing net given by schematic (unconnected-(UA-Pad24)). 
Pad 24 of U4 on F.Cu 

Warning: Pad missing net given by schematic (unconnected-(U4-Pad25)). 
Pad 25 of U4 on F.Cu 

Warning: Pad missing net given by schematic (unconnected-(U4-Pad26)}). 
Pad 26 of U4 on F.Cu 


Tab] 
Show: © All Errors © Warnings 9 Exclusions Save... a 
Dolota Marker Delete All Markers Close Run DRC sd mera 

z RE 

Y tis Y ae 


11.5.9.37: Zero violations and unconnected items. 


With all DRC issues fixed (and some ignored), I will finish this segment by completing the 
silkscreen work. I want to add a few text labels with board information and two logos in the 
back silkscreen layer. I will also add "Vcc" and "GND "text labels in the battery connector 
terminals. You can see the completed layout, with final tracks and silkscreen, below: 


MOAT 


11.5.9.38: Final version of the two-layer board. 
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In the figure above, I have reduced the opaqueness of all elements except for the silk- 
screen. This way, it is easier to see the silkscreen text and graphics. The 3D viewer pro- 


duces a better view: 


Data logger with [icad 


the ATMega328P. 


DESIGNED WITH 


Tec 
IER 


— 2Mbit EEPROM 
RTC 
12C, SPI, GPIOs 


11.5.9.39: A 3D rendering of the board. 
Let's save the changes and commit them to the Git repository: 


% git status 
On branch 2layer 
Changes not staged for commit: 
(use "git add <file>..." to update what will be committed) 
(use "git checkout — <file>..." to discard changes in working directory) 


modified: MCU Datalogger.kicad_pcb 
modified: MCU Datalogger.kicad_prl 


modified: MCU Datalogger.kicad_sch 


no changes added to commit (use «git add» and/or «git commit -a») 
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% git commit —am "Fixed outstanding issues." 
[2layer 773817] Fixed outstanding issues. 
3 files changed, 7230 insertions(+), 2214 deletions(-) 


You are close to completing this project. We'll do a final DRC in the next segment and then 
export the Gerber files and upload them to the manufacturer's website. 


11.5.10. Layout 6 - Design Rules Check 

You have done a lot of work on this PCB, and you are very close to passing the finish line. 
In the previous segment of this chapter, I spent additional time fixing violations that I in- 
troduced when I changed the width of the Vcc track that came out of pad one of the battery 
connector. It is time for one last DRC before exporting the Gerber files to ensure that I (or 
you) haven't missed any violations. 


o $ DRC Control 


Refill all zones before performing ORC Test for parity between PCB and schematic 
Report all errors for each track 


Violations (0) | Unconnected Items (0) Schematic Parity (11) 


Pad 6 of U4 on F.Cu 

v Warning: Pad missing net given by schematic (unconnected-(U4-Pad13)). 
Pad 13 of U4 on F.Cu 

v Warning: Pad missing net givenby schematic (unconnected-(U4-Pad14)). 
Pad 14 of U4 on F.Cu 

~ Warning: Pad missing net given by schematic (unconnected-(U4-Pad19)). 
Pad 19 of U4 on F.Cu 

~ Warning: Pad missing net given by schematic (unconnected-(U4-Pad22)). 
Pad 22 of U4 on F.Cu 

v Warning: Pad missing net given by schematic (unconnected-(U4-Pad23)). 
Pad 23 of U4 on F.Cu 

v Warning: Pad missing net given by schematic (unconnected-(U4-Pad24)). 
Pad 24 of U4 on F.Cu 

v Warning: Pad missing net given by schematic (unconnected-(U4-Pad25)). 
Pad 25 of U4 on F.Cu 

v Warning: Pad missing net given by schematic (unconnected-(U4-Pad26)). 
Pad 76 af [Idan F An 


Show; All Errors Oo Warnings a Exclusions Save... 
Delete Marker Delete All Markers Close 


11.5.10.40: The last DRC reveals several warnings. 


The last DRC reveals several schematic parity warnings. Here's a list of the two warning 
types and what they mean: 

e "Warning: Extra footprint. " This warning relates to a footprint that exists in the 
layout editor that has no symbol counterpart in the schematic. 1 had two such 
warnings, one of each logo in the back layer (the Tech Explorations and KiCad 
logos). Such warnings are safe to ignore. In KiCad 6.0 or newer, you can mark a 
footprint as "Not in schematic" to prevent similar warnings in the future. You will 
find the "Not in schematic" checkbox in the footprint's properties window (see 
screenshot below). 

e "Warning: Pad missing net given by schematic...". This warning relates to pads that 
I have marked as "unconnected" in the schematic. Also safe to ignore. 
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= 
ee Footprint Properties. 
General Clearance Overrides and Settings 30 Models 
Toxt Items ] show JONAS: aes 0681 00 
Reference designator REFI 1 015 E BSitkscreen 
Value KiCad-Logo2_5mm_SilkScreen 1 1 0.15 H trb 
+ ' 
ea Suma Update Footprint from Library... 
Unlock footprint 
x 102.616 mm 
footprint Change Footprint... 
Y 78613 mm o: 
mae Ə Edit Footprint... 
Auto-placamant Rides 
Deer Allow 90 degree rotated placement: 
00 
900 o 0 0 8 
-90.0 
O 1900 Allow 180 degres rotated placement: 
Other: 180,000 o 0 -0 
Library ink: Symbol:KiCad-Logo2 Smm sSikScrien Cancel OK 


11.5.10.41: If a footprint exists only in the layout file, you can mark it as 
"Not in schematic" in the footprint's Properties window. 


All of the items in the DRC belong to the two types of warnings that I can safely ignore. I 
can now declare that this board is ready to export and manufacture 


Data logger with icad ` 


the ATMega328P. 


= 12C, SPI, GPIOs 


— 2Mbit EEPROM 
TC 


11.5.11.42: Inspecting the board in the 3D viewer. 
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11.5.11. Layout 7 - Manufacture 

Let's finish the layout design workflow. In this segment, you will export the Gerber files for 
your new board and upload them to your preferred manufacturer's website. 

Start by doing a visual inspection of the front and back layers using the 3D viewer. Check 
for issues in the silk-screen, pads, copper fills, and missing or mal-positioned components. 
The only element that I changed after looking at the 3D rendering of the board was to move 
the ICSP pinout table upwards so that it is closer to the ICSP header. 

Save the design, and open the plotter window (see chapter "8.17. How to export and test 
Gerber files" if you need a refresher on how to export the Gerber files). You can see my 
settings for the Gerber and drill files below: 


Plot format: Gerber $ Output directory: MCU_Datalogger_Gerbers/ 1] 
incuded Layers General Options 
v Fey Plot border and title block * Drill marks: 
Y Beu Y Plot footprint values Sealing: 
cee Y Plot reference designators Plot mode; 
u h 
vor a = Force plotting of invisible values / rets Use drillipiace file origin 
Y Beste Plot Edge.Cuts on all layers 
Y  FsSilkscreen Sketch pads on fab layers 
Y  BSilkscreen Do not tent vías Y Check zone fills before plotting 
Y FoMask 
Y  B.Mask Gerder Options 
O y Use Protel filename extensions Coordinate format: 4.6, unit mm 9 
y Pond Y Generate Gerber job file Y Use extended X2 format (recommended) 
Usar Eco? Subtract soldermask from silkscreen Y Include netlist attributes 
Y  Edge.Cuts Disable aperture macros (non recommended) 


Output Messages 


Show: All v Errors Y Warnings v Actions v Infos Save... 
Run DRC... Close Generate Dril Files.. Piot 
& Layer files 
... Generate Drill Fites 
Output folder. MCU_Datalogger_Gerbera/ = 
Drift Fee Forman On Gign Mete Counts 
Excellon O Absoluta Pirated pacs: 25 
Drilifplace file origin Non-platod pade 4 
ii Through vas: 48 
Micro vies: o 
Oval Hains Drit Vode Buried vist ° 


Laros Format 
O Gorder x2 


Map Fle Format 
Pa 
O eais Precivon: 40 


DXF 
SvG 
POF 


Massager 


Created tila '/Users/paterDocuments/Kicad/Course development documents/KCad Like a Pro 3e Projecta/MCU Datalogger) 
U gb 


tapKicad/C 
NCU_Datalogger_Gerbers/MCU Datalogger-MPTH-drl gbr* 


Generate Report Ple Clove Geneste Moore = ETS 


2) Drill files 


11.5.11.43: Generating the Gerber files. 
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Open the KiCad Gerber viewer to inspect the new Gerber files. Enable and disable each 
layer and assess their validity. Is anything missing? Is something not looking correct? Now 
is the time to address any issue that may affect the manufactured PCB. 


sine 


o. “4D 


11.5.11.44: The Gerber viewer displaying the front copper layer. 


I did not see any problems in my instance of the Gerber files, so I continued with the upload 
to the manufacturer. To place the order on my manufacturer's website, I need the dimen- 
sions of the board. So, go back to Pcbnew and use the measurement tool to get the width 
and height of the board. An alternative method is to add the full board characteristics to 
one of the user layers. Use "Add Board Characteristics" under the Place menu item: 


KiCad File Edt View PER Route inspect Tools Preferences 
o 


one 
lana! Add Footprint 
ck: use netclass width El |; JE Add Filled Zone po mm 
¿$ Add Rule Area QNK 
+10 Add Microwave Shape > 
T Add Text ORT 


ae 


o 
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As you can see below, this board measures 51.73 mm X 34.59 mm: 


re, | BOARD CHARACTERISTICS 


spp 


DAMA Sik 
$ 


j 
' 


i 


11.5.11.46: The board dimensions, and other information. 


For this board, I will use PCBway as the manufacturer. You can see the order form below 
after I have entered the board dimensions: 


<i 2 . . a 
& PCB Specification Selection Quick-order PCB >> 
Soar F Single pieces Panel by Custorr Panel by PCBWay 
jn 1 2 eg 
o o 
* Size (single) X mm inch'=mm Ta i o E o 
Qua { 
r e e ( e e 4 e 
Matena HDIB . ye E 
Pi PBurearna vas) QU) Copper 

“Material model can be remarked below. HDI is available for 4-layer or more. 
FR4-TG TG 130-140 TG 150-160 
Thi 
Ain Tra pacing 
Min Hole Size 0.15mm 0.2mm No Drill O 

W Pupe W Matteblack Wi Mattegreen ZN 
dge connector Yi No 

11.5.11.47: My PCB order form. 
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Most of the options in this order form as straightforward, but there are a couple I'd like to 
confirm: the minimum track spacing and minimum hole size. The values I have marked in 
the figure above will give you the lowest manufacturing price for the board. But are they 
correct? 

My board characteristics information shows that minimum track spacing is 0.2 mm and 
minimum hole diameter is 0.3 mm. I have selected 6 mil for the spacing and 0.3 mm for 
the hole diameter in the order form. With the help of a converter, I learn that 0.2 mm is 
7.87 mils. Therefore, the manufacturer's minimum track tolerance is lower than that of my 
board, and as a result, I can continue with the order without making any changes. If my 
board's minimum track spacing were lower than my selection in the order form, I would 
have had to select a smaller minimum track spacing, such as 4 or 5 mils. 

The hole diameter at 0.3 mm for both my board and the order form are also in agreement. 
Therefore, I can continue with the order. 

There is one last thing to do before you complete the two-layer PCB project: commit your 
latest changes to the Git repository. Here is my command line session: 


% git status 
On branch 2layer 
Changes not staged For commit: 
(use "git add <file>..." to update what will be committed) 
(use "git checkout — <file>..." to discard changes in working directory) 


modified: MCU Datalogger.kicad_pcb 
modified: MCU Datalogger.kicad_prl 


Untracked files: 
(use «git add <File>...» to include in what will be committed) 


MCU_Datalogger_Gerbers/ 


no changes added to commit (use «git add» and/or «git commit -a») 
% git commit —am "Completed 2-layer PCB project." 
[2layer bbeffea] Completed 2-layer PCB project. 

2 files changed, 236 insertions(+), 167 deletions (-) 


In the Git command line session above, you can see that Git detected new untracked files 
in the «MCU_Datalogger_Gerbers» directory. I chose not to track those files because they 
are not needed. Gerber files can always be generated, and keeping them in the repository 
would only increase bloat. 

At this point, the project is complete. However, there are two more things that I would like 
to show you. 

First, how to add the missing 3D shapes so that the 3D render of the board looks as realistic 
as possible. 

Second, how to use the same schematic to produce a four-layer version of the board. This 
will also allow you to practice your Git skills further. 
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11.6. 3D shapes 

In this chapter, you will improve the realism of the 3D viewer. Currently, the 3D viewer 
renders the board where only the resistors, capacitors, and pin headers have 3D models. 
Let's address this by adding the 3D models for the remaining footprints. 

In the figure below, you can see the current 3D viewer rendering (left) and its look at the 
end of this chapter (right). 


Before After 
Figure 11.6.1: "Before" and "After" renders from the 3D viewer. 


To add the missing 3D models, you will need to open the properties window for each related 
footprint. These footprints are missing a 3D model: 

e U4 (the MCU). 

e U3, U1, U2 (the two EEPROM chips and the real-time clock). 

e Y1 and Y2 (the two crystal oscillators). 


If you need a reminder about adding a 3D model to a footprint, please read the relevant 
chapter. 

For the MCU footprint, I used the TQFP-32_7x7mm model. This model is available in the 
"Package_QFP" library that comes with KiCad. You can see my settings below: 
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o... Footprint Properties 


General Clearance Overrides and Settings 3D Models 


3D Model(s) 


+ 
” 
mi 


EERE 


Rotation SEPA DEN 


pS 

2 

3 

e 

3 
CE 


X: 0.0000 mm 
Y: 0.0000 mm 
Z: 0.0000 mm 


CECEK 


Opacity 


0 100 100 


Library link: Footprints:QFP80P900X900X120-32N Cancel 


Figure 11.6.2: Settings for the MCU 3D model. 


Continue with U1. The 3D model I used for this footprint is the «SOIC-8_3.9x4.9mm_ 
P1.27mm.wrl» in the «Package_SO» library. See my configuration below: 


Oo o Footprint Properties 


General Clearance Overrides and Settings 3D Models 


3D Model(s) Show 


| SIKICADE_3DMODEL_DIRYPackage_SO.3dshapes/SOIC-8 3.9:4:Pmm_P1.27mmwrl — Ja 


+ b ú Configure Paths... 
Scale 


X: 1.0000 
Y: 10000 
Z: 10000 


<> e O’ 


Rotation 
X: 0.00 deg 


Y: 0.00 deg 
Z: 0.00 deg 


> e) <> 


Offset 

X: 0.0000 mm 
Y: 0.0000 mm 
Z: 0.0000 mm 


«> 0. 


Opacity 


0 100 100 


Library link: Packaga_SO:SOIC-8_5.23x5.23mm_P1.27mm Cancel PU 


Figure 11.6.3: Settings for the EEPROM chip 3D model. 
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I used the same model for the second EEPROM chip and the real-time clock. Copy the 3D 
model path and file, and paste it in the 3D model's row for U2 and U3. 

Two models remain for the crystal oscillators. For Y2, use model "Crystal_SM- 
D_0603-2Pin_6.0x3.5mm" in the "Crystal" library: 


o... Footprint Properties 


General Clearance Overrides and Settings 3D Models 
3D Model(s) Show 
A T R 


+ & L Configure Paths... 
Scale 
X: 1.0000 


Y: 1.0000 
Z: 1.0000 


<> <> <> 


Rotation 

X: 0.00 deg 
Y: 0.00 deg 
Z. 0.00 deg 


<> <> <> 


x 
2 
3 
Ss 
3 
3 
<> <> <> 


Library link: Crystal:Crystal_SMD_5032-2Pin_5.0x3.2mm_HandSolderina Cancel pr 


Figure 11.6.4: Settings for the Y2 crystal oscillator. 


For Y1, use the same model as in Y2 to copy the model path across. 
All footprints now have a 3D model. Here's the resulting 3D rendering: 
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Figure 11.6.5: 3D render of the board with all 3D models assigned. 
The 3D viewer can now produce a more realistic rendering of the board. 


11.7. Merge 2-layer branch to main 

In this chapter, you will merge the "2layer" Git repository branch into "main." The "2layer" 
branch contains all changes relating to your work in the two-layer PCB. In the next chap- 
ter, you will begin work on a four-layer version of the PCB. But first, merging "2layer" into 
"main" will ensure that "main" contains the latest version of the schematic. 

Remember that I found an error in the schematic during the layout design, which I fixed 
and committed the change in the current working branch ("2layer"). I plan to create a new 
working branch for the four-layer PCB, which will branch out of "main." 

Another benefit of merging "2layer" into "main" is that the merge will also bring all two-lay- 
er layout changes into "main." This means that the new "4layer" branch will inherit the 
layout from the "main" branch, along with the refined outline in the Edge.Cuts layer, place- 
ment of the footprints, and even the 3D models. To design the four-layer version of the 
PCB, you will only need to delete the current copper tracks and fills, change the board 
layout to four layers, and redraw tracks and fills. 

Before working with Git, I suggest one naming convention change. Currently, the name of 
the folder that contains the two-layer Gerbers is "MCU_Datalogger_Gerbers." Change this 
to "2_layer_MCU_Datalogger_Gerbers". Soon, you will have a second Gerbers directory 
called "4_layer_MCU_Datalogger_Gerbers". You will not track these folders in Git, but they 
will co-exist in your project directory. 

Let's continue with Git. Ensure that you have saved all your work. Open your terminal win- 
dow. Check the current status of the repository with the "status" command: 
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% git status 
On branch 2layer 
Changes not staged for commit: 
(use "git add <file>..." to update what will be committed) 
(use "git checkout -- <file>..." to discard changes in working directory) 


modified: MCU Datalogger.kicad_pcb 
modified: MCU Datalogger.kicad_prl 
modified: MCU Datalogger.kicad_sch 


Untracked files: 
(use «git add <file>...» to include in what will be committed) 


2_layer_MCU_Datalogger_Gerbers/ 


no changes added to commit (use "git add» and/or «git commit —a») 


% 


You can leave the Gerbers directory untracked. Commit the three changed and tracked files 
to the working branch: 


% git commit —am "Completed 2-layer PCB." 
[2layer a49la4c] Completed 2-layer PCB. 
3 files changed, 18 insertions(+), 9 deletions(-) 


The 2layer branch contains all changes. Continue to merge the changes in 2layer with the 
main branch. You can do this in two steps: 

1. Switch your working branch to «main» using the «checkout» command. 

2. Merge "2layer" into "main" using the "merge" command. 


Here is my Git command line session: 


% git checkout main 
Switched to branch 'main' 
% git status 
On branch main 
Untracked files: 
(use "git add <file>..." to include in what will be committed) 


2_layer_MCU_Datalogger_Gerbers/ 
nothing added to commit but untracked files present (use «git add» to track) 
% git merge 2layer 


Updating cla0d5e..a49la4c 
Fast-forward 
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MCU Datalogger.kicad_pcb | 15236 +44 A A A HEHE EEEEEFEEF EE EAE HEE A A A A A 
MCU Datalogger.kiEad_pr1 | 26 +- 
MCU Datalogger.kicad_pro | 8 +- 
MCU Datalogger.kicad_sch | 5 +- 


4 files changed, 14092 insertions(+), 1183 deletions (—) 


From this point, until you switch to a different branch, you will be working in the main Git 
branch. 

To avoid Git reminding me to track the Gerber directories, I will add them to the «.git- 
ignore» file. Below you can see the updated contents of this file: 


.DS_Store 

fp-info-cache 

MCU Datalogger-backups/x* 
2_layer_MCU_Datalogger_Gerbers/x 
4_layer_MCU_Datalogger_Gerbers/x 


Save the updated ".gitignore" file, and commit the change to the ".gitignore" 
file to the main branch: 
% git status 
On branch main 
Changes not staged for commit: 
(use "git add <File>..." to update what will be committed) 
(use "git checkout — <file>..." to discard changes in working directory) 


modified: .gitignore 


no changes added to commit (use «git add» and/or "git commit -a") 

% git commit —am "Added gerber directories to gitignore." 

[main ecf6970] Added gerber directories to gitignore. 

1 file changed, 2 insertions(+), 1 deletion(-) 
In the next chapter, you will begin work in the four-layer version of the PCB, and to track 
changes in the layout, you will create a new working branch. 


11.8. Design 4 Layer PCB in new Git branch 

Let's begin work on the four-layer version of the PCB by creating a new branch in the pro- 
ject's Git repository. Currently, the repository contains two branches. The current working 
branch is "main" (identified as active by the asterisk). The "2layer" branch contains chang- 
es relating to the two-layer version of the PCB. The two branches are in sync, and there are 
no uncommitted changes. 

You can use the "branch" command to get information about repository branches: 
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% git branch 
2layer 
* main 


% 


Create a new branch to track changes in the four-layer version of the PCB. The name of the 
new branch is "4layer". Here is my command line session: 


% git checkout -b 4layer 
Switched to a new branch '4layer' 
% git status 

On branch 4layer 


nothing to commit, working tree clean 


% 


You are now working in the "4layer" branch, which is clean (i.e., there are no pending 
changes” and tracking for changes. 


In the next chapter, you will go straight into Pcbnew, change the board configuration to four 
layers, and remove and redraw all copper tracks and fills. 


11.9. Four-layer PCB routing 

Because of the layout work in the two-layer PCB already committed to the Git repository, 
most of the design work is already complete. Layout workflow steps 2 (outline and con- 
straints), 3 (component placement), and 5 (silkscreen) is complete and does not require 
any modifications. 

This chapter will re-work steps 1 (setup) and 4 (routing and copper fills). You will also do 
a DRC (step 6). In the next chapter, you will export the new Gerber files, check them for 
fitness, and upload them to the manufacturer. 

Let's begin. 

Open Pcbnew. First, remove all tracks and fills using the Global Deletions window from the 
Edit menu: 
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Figure 11.9.1: Delete all tracks, vias and zones. 


The layout will retain all other design elements. Here is the current state of the board: 
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In the Board Setup window, under Board Stackup, Physical Stackup set the number of 
copper layers to 4: 


Figure 11.9.2: The board without tracks, vias, and filled zones. 
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Figure 11.9.3: Switch the number of copper layers to "4". 


My routing strategy for the four-layer board is similar to the two-layer board. I tried to draw 
the route signal routes (that is, all routes other than those that belong to the Vcc and GND 
nets) in the top, Ini, and In2 copper layers. 

I will draw the first one connected to the GND net in the bottom layer and the second con- 
nected to the Vcc net in the Ini layer for the copper fills. 

You can see the resulting four-layer PCB below: 
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Figure 11.9.4: The completed four-layer PCB. 


Do a DRC to ensure that the board does not contain any actionable violations. 
Save the new layout, and commit the changes to Git: 
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% git status 
On branch 4layer 
Changes not staged for commit: 
(use "git add <file>..." to update what will be committed) 
(use "git checkout — <file>..." to discard changes in working directory) 


modified: MCU Datalogger.kicad_pcb 
modified: MCU Datalogger.kicad_prl 


no changes added to commit (use «git add» and/or «git commit —a») 
% git commit —am "Completed 4-layer pcb routing." 
[4layer a316bc1] Completed 4-layer pcb routing. 

2 files changed, 12486 insertions(+), 8043 deletions(-) 


Let's continue with the manufacturing of the board. 


11.10. Four-layer PCB manufacturing 

Let's manufacture the PCB. I will be using the same settings as the two-layer PCB, except 
I will now choose four layers instead of 2 in the order form. The board dimensions and 
tolerances remain unchanged. 

Generate the Gerber files: 
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Figure 11.10.1: Generating the Gerber files. 
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Test the generated Gerber files using the KiCad Gerber Viewer app: 
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Figure 11.10.2: Testing the Gerber files in Gerber Viewer. 


Finally, upload the Gerber files ZIP archive to the manufacturer's website. Below you can 
see my order settings: 
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Figure 11.10.3: Four-layer PCB order form. 
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The only difference between the order form for the four-layer PCB and the one for the 
two-layer PCB is the number of layers (see above). 

Let's finish this project by committing the changes to the "4layer" Git branch (save chang- 
es in the editor if you haven't done so already): 


% git status 
On branch 4layer 
Changes not staged for commit: 
(use "git add <file>..." to update what will be committed) 
(use "git checkout — <file>..." to discard changes in working directory) 


modified: MCU Datalogger.kicad_pcb 


no changes added to commit (use «git add» and/or «git commit -a") 
% git commit -am "Completed 4-layer PCB." 


[4layer f5b6b0b] Added board characteristics. 
2 Files changed, 55 insertions(+), SS deletions(-) 


With this commit, this project is complete. 

However, there is one more skill that I want to demonstrate in the next chapter. Imagine 
the situation where you need to change the schematic after you have completed work on 
the two versions of the PCB layout. At the file level, this change will exist in the schematic 
file of the repository's main branch. You will then need to sync the changes in this file to the 
other two branches («2layer» and «4layer») without modifying the layout files. 

How can you do this? I will show you in the next chapter. 


11.11. Updating layout from changes to the schematic with Git 

In this chapter, I will demonstrate a solution to the problem of how to use Git to import 
changes to the schematic into layouts that exist in different branches. This problem is com- 
mon in situations where you have a KiCad project with a single schematic but more than 
one layout. 

To solve this problem, you will need to use Git. 

There is a single schematic tracked in the main branch in the MCU datalogger project that 
you completed. There are two versions of the layout; a two-layer layout tracked in the 
"2layer" branch, and a four-layer layout tracked in the "4layer" branch. A slightly different 
scenario would call for a single schematic informing an SMD and a THT version of a two-lay- 
er board. 

In either case, you will likely want to make changes to the schematic at some point. For 
example, you may want to add new components or fix a bug. The individual schematic file 
will need to be synced between the main branch and the branches of the layouts. 

You already know how to merge two branches. You can use the "merge" command. The 
problem with this option is that the" merge" command would merge the schematic file and 
all files between the branches involved. This is risky, as it could overwrite the layout files of 
one version of the PCB with that of another. 
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There is a safer option by which you can use Git to merge specific files between branches. 
This gives you maximum flexibility and removes all risks. In the case of the current pro- 
ject, it is possible to use Git to merge changes to the "MCU Datalogger.kicad_sch" file only 
between branches and ignore everything else. The Git feature that I will use in the exam- 
ple that follows is called "gitattributes". You can use gitattributes in an extensive range of 
situations, but in this case, I will use it to set up a merge strategy to allow me to merge a 
single file between branches. 

Let's look at an example using the MCU datalogger project as we left it in the previous 
chapter. Begin by getting the status and the current list of branches in the repository: 


% git status 
On branch 4layer 
nothing to commit, working tree clean 
% git branch 
2layer 
x 4layer 
main 


I am currently working on the «4layer» branch, and the repository contains three branches. 
Say that you want to make a change to the schematic. First, switch into the «main» branch: 


% git checkout main 
Switched to branch 'main' 


% 


Next, create a new file with the name ".gitattributes." You can see the content of this file 
below (a single line): 


MCU Datalogger.kicad_pcb merge=pcb 


This line informs Git to ignore files with "MCU Datalogger.kicad_pcb" during a merge oper- 
ation. You may also use a wildcard character in the name, if you prefer, such as "*.kicad_ 
pcb," which would cause Git to ignore all files with this extension. The name of this merge 
rule is "PCB." This is an arbitrary name, and you can change it if you wish. 

Merge this new file into the main branch: 


% git add . 
% git commit -am "Added gitattributes file to prevent PCB Files from merge." 
[main 3Zc16f8] Added gitattributes file to preven PCB files from merge. 

1 file changed, 1 insertion(+) 

create mode 100644 .gitattributes 


Open Eeschema, and make a change to the schematic. I have added a new net label in one 
of the un-named nets, as you can see below: 
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Figure 11.11.1: Made a change to the schematic. 


Save the change, and commit it to the "main" branch: 


% git commit -am "Made small change to schematic." 

[main 7e48d78] Made small change to schematic. 

1 file changed, 4 insertions(+) 
Say that you would like to update the four-layer PCB with the latest change in the schemat- 
ic. Switch your working branch to "4layer": 


% git checkout 4layer 

Switched to branch '4layer' 
Next, merge the changes in "main" into "4layer". Git will you to type in a commit message. 
I typed this: "Merging an update to the schematic" and then saved the text editor to com- 
plete the merge operation. 


% git merge main 

Merge made by the 'recursive' strategy. 
.gitattributes | 1 + 
MCU Datalogger.kicad_sch | 4 ++++ 


2 files changed, 5 insertions(+) 
create mode 100644 .gitattributes 


Two files were merged. The merge contained the new ".gitattributes" file and the changes 
in the schematic file. 

Confirm that the change in the schematic editor appears in the "4layer" branch. Close 
Eeschema if it is still open, and then re-open it. Confirm that the new net label appears: 
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Figure 11.11.2: The new net labels appears in the schematic in the "4layer" branch. 


Open the layout editor and update it with the changes from the schematic editor. Below you 
can see a detail of the layout editor that shows the new net label: 


Figure 11.11.3: The new net label appears in the four-layer PCB. 


You can repeat the process to update the two-layer PCB with the change in the schematic. 


11.12. Finding and correcting a design defect 

As part of the beta program of this book, reader Antti found a bug in the schematic of this 
project. This bug required corrections in both the schematic and the layout. Instead of 
re-writing the chapters in this part of the book, I introduced this chapter. I preferred not to 
obscure the reality that errors are a natural part of the engineering that leads to fixes and 
improvements. 
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In this chapter, I will document the bug that Antti found and how I iterated through the 
design of the project's PCB to fix it. 


The primary defect 

In step four of the schematic workflow, I introduced the bug when I incorrectly wired the 
SCL pin (from the 12C interface) together with the SCK pin (from the SPI interface). Both 
SCL and SCK convey clock signals, but, of course, those signals belong to different commu- 
nication interfaces and should be kept separate. 

In the figure below, I use arrows to highlight the location of the bugs. 


Y T z T x T = T = 1 5 


ec 


G 0 
T I T x T T E T 6 


Figure 11.12.1: The location of the defects. 


The secondary defect 

I worked on the fix for the SCL-SCK bug on KiCad 6.0.0 rc1. I designed the PCB of this 
project in an earlier version of KiCad. As you can see in the figure above, I have used two 
PWR_FLAG symbols. I placed one PWR_FLAG in the Vcc net in the MCU group and another 
in the Vcc net of the "Real time clock" group. While the ERC in the earlier version of KiCad 
did not complain about the two PWR_FLAG symbols, KiCad 6.0.0 rci did. I addressed this 
issue in the schematic fix. 


The fixes 

I created a new «SCL» net label to fix the primary defect and attached it to all SCL pins, 
including pin 28 of U4. I also added a new hierarchical pin label to the connector in the 
Connectors sheet. 
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I deleted one of the two PWR_FLAG symbols to fix the secondary defect. While addressing 
the defects, I keep the complete history of the changes in the project's Git repository. This 
was an excellent opportunity to see how Git and KiCad can work together in a real-life 
situation. 


11.12.1. Fix the schematic 
I will begin fixing the two defects in the 2layer branch. I plan to: 
1. While in the 2layer branch, update the schematic (set the correct net labels and 
delete the redundant power flag). 
. Merge the updated schematic file into the main branch. 
. Merge the updated schematic into the 4layer branch. 
. Return to the 2layer branch to update the 2-layer board layout. 
. Return to the 4layer branch to update the 4-layer board layout. 


UAWN 


An essential element of the process that I outline above is merging changes in the main 
branch into the 4layer branch while ignoring changes to the PCB layout file. I have de- 
scribed how to set up this capability in the earlier chapter, "11.11. Updating layout from 
changes to the schematic with Git". My instructions below will not work without first setting 
up the ".gitattributes" file in the main branch. 


Fix the schematic in the 2layer branch 
Open your terminal, switch into the project's KiCad directory, and ensure that you are 
working in the 2layer branch: 


% git branch 
2l-experimental 
x 2layer 
4l-experimental 
4layer 
main 
As you can see in my terminal session above, I am working in the 2layer branch. Continue 
in the schematic editor. Fix the secondary defect (the redundant power flag) by deleting it. 
I use the interactive delete tool for this: 
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Figure 11.12.1.2: Delete the redundant power flag. 


Do an ERC and confirm that the check is no longer complaining about the power flag issue. 
Continue to fix the problem with the net labels. In the Atmega328P module, pin PB5 (#17) 
conveys the SCK signal, the clock for the SPI interface. 1 have attached the correct net label 
"SCK" in the schematic. However, pin PC5 (#28) conveys the SCL signal, the clock for the 
12C interface. This is the core of the bug (I have incorrectly attached the SCK net label). 
To fix this, delete all instances of the SCK net label, except for the one attached to U4 pin 
17. Look at Figure 11.12.1 for a guide on the exact location of the SCK labels to delete. 
To replace the deleted net label, create a new net label with the name "SCL." Attach in- 
stances of this label in all SCL pins (footprints U2, U4, U1, U3). You will also need to create 
a new hierarchical label named "SCL" for the Connectors sheet and expose it to the root 
sheet. 

You can see the two sheets of this project with the net and hierarchical labels corrected in 
the two figures below. 


Figure 11.12.1.3: The root sheet with corrected net labels. 
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Figure 11.12.1.4: The Connectors sheet with corrected net labels. 


Do a visual check to ensure you haven't forgotten anything, and then an ERC. There should 
be no errors. My ERC showed a couple of symbol violations ("modified in library") which 1 
can safely ignore. 

Save the schematic and return to your terminal window. Check the Git status, add the 
changes to staging, and commit them. Here is my session: 


% git status 
On branch 2layer 
Changes not staged for commit: 
(use "git add <file>..." to update what will be committed) 
(use "git checkout -- <file>..." to discard changes in working directory) 


modified: MCU Datalogger.kicad_pcb 
modified: MCU Datalogger.kicad_prl 
modified: MCU Datalogger.kicad_pro 
modified: MCU Datalogger.kicad_sch 
modified: connectors.kicad_sch 


no changes added to commit (use «git add» and/or «git commit —a») 
% git add. 
% git commit —am 
"Fixed two defects in the schematic." 
[2layer c84e21c] Fixed two defects in the schematic. 
5 files changed, 5141 insertions(+), 4860 deletions(-) 
% git status 
On branch 2layer 
nothing to commit, working tree clean 


% 
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At this point, you have fixed the bugs in the schematic and have committed the changes to 
the 2layer branch in Git. Let's merge these changes in the main branch. 


Merge changes to 'main' 
To switch your working branch to "main", use the "checkout" command: 


% git checkout main 


Next, merge the changes committed in the 2layer branch into main. For this, use the 
"merge" command: 


% git merge 2layer 

Auto-merging MCU Datalogger.kicad_sch 

CONFLICT (content): Merge conflict in MCU Datalogger.kicad_sch 
Auto-merging .gitignore 

CONFLICT (content): Merge conflict in .gitignore 

Automatic merge failed; fix conflicts and then commit the result. 


% 


Unfortunately, Git was unable to merge the changes automatically. There are changes in 
two files that have conflicts that I had to resolve in my instance manually. Git has inserted 
markers in those files to help me find the conflicts. 

Let's look at the first conflicted file, "MCU Datalogger.kicad_sch". 


In the main KiCad window, right-click on the schematic editor icon and select "Edit in text 
a editor". 


eee MCU Datalogger — KiCad 6.0 
sa. a : 
E cu patalogger kicad_pro Edit the ere cohen 
= [=] MCU Datalogger-backups 
Bi 2_Jayer_MCU_Datalogger_Gert ‘Symbol Editor 
En 4_Jayer_MCU_Datalogger_Gerl Edit global and/or project schematic symbol libraries 
Ea Graphics 


IM Libraries 


& MCU Datalogger.kicad_pcb 


+ 


anaa 


Footprint Editor 
Edit globai and/or project PCB footprint libraries 


Gerber Viewer 
i Preview Gerber files 
Image Converter 
Convert bitmap images to schematic symbols or PCB footprints 


eB Calculator Tools 


El = Show tools for calculating resistance, current capacity, ete. 


Drawing Sheet Editor 
Edit drawing sheet borders and title Blacks for use in schematics and PCB designs 


Plugin and Content Manager 
Manage downloedable packages from KiCad and 3rd party repositories 


Figure 11.12.1.5: Open file in the text editor. 
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If you don't see this option, you will need to set up a text editor in the KiCad Preferences 
window. You will find the "Common" tab (see below). 


... Preferences 
Ao Editing 
Mouse and Touchpad . 
Hotkeys Accelerated graphics; High Quality Antialiasing 8 Warp mouse to origin of moved object 
First hotkey selects tool 
Session 
Remember open files for next project launch 
© System default PDF viewer 
Other: a Auto save: 10 $ minutes 
File history size: a $ 
User: imertece 3D cache file duration: 30 $ days 
Show icons In menus 
Project Backup 
Automatically backup projects 
Create backups when auto save occurs 
Maximum backups to keep: 25 5 
Maximum backups per day: 5 S 
Minimum time between backups: 5 S minutes 
Maximum total backup size: 100 $ MB 
Reset Common to Defaults Cancel 


Figure 11.12.1.6: Setup your preferred text editor. 


Once the schematic file is loaded in the text editor, scroll down until you find the marker 
"<<<<<< HEAD". Git marks the conflicted segments of the file with these markers. On top 
is the text from the main branch, and under the "======" marker, you see the version 
coming from the 2layer branch. In this case, I will delete the conflicting text from the main 
branch and keep the one from the 2layer branch. I depict the resolved conflict below: 


lutat“ "SDA" (at 127 154.94 180) (uuid 51928f1c-1f4b-4e8d-9d4f-aala861564e7) 
leffects (font (size 1.27 1.27)) (justify rion bottom) ) ) 
(uuid 52b4647a-9067-41a4-913e-407918d10cf3) {label "SDA" (at 127 154.94 180) 
(effects (font (size 1,27 1.27)) (justify right botto 
) 


(label "TX" (at 179.07 135.636 180) 
bo (font (size 1.27 1,27)) (justify iow bottom) ) ) 
uuid $41e0cb5-2ef2-4765-abae-0d777d4bSf5F) 
(label "TX" (at 179.07 135.636 180) 
<ececce HEAD (effects (font (size 1.27 1.27)) (justify aan botto 
(label "Abc123" (at 173.99 34.29 0) 
(effects (font (size 1.27 1.27)) (justify left bottom)) 


y (uuid 35adadb2-a853-4483-4913-b47252416313) label "MISO" (at 173. 07 148.59 180 
(label “Vcc” (at 179.07 83.82 180) ustify right botto 


Ps (uuid 598e3233-9971-4eeb-ba8d-e1ba68fbdfa5) 
(label “MISO” (at 179.07 148.59 180) ) 


>>>>>>> 2 layer (label "SCL" (at 100.33 149,86 0) 
sa e 7 : y CENS Monte (effects (font (size 1.27 1.27)) (justify left bottom 
(uuid 598e32a3-9971-4eeb-ba8d-e1ba68fbdfa5) (uuid 5a5caf62-dee5-4b30-b12e-ddc584d88137) 
(label "SCL" (at 100,33 149.86 0) ) mas 
(effects (font (size 1.27 1.27)) (justify left bottom)) (label "D8" (at 191.77 45.72 180) 
(uuid SaScaf62-dee5-4b30-b12e-ddc584488137) (effects (font (size 1.27 1.27)) (justify right botto 
) (uuid 610b65ac-79d8-4d1b-b8@a—b1de87204089) 


Conflicted Resolved 
Figure 11.12.1.7: Resolving a Git merge conflict. 


Save the text file. Repeat the process for the second conflicting file, ".gitignore". You will 
not be able to use the KiCad main window to open ".gitignore" in a text editor, so use your 
editor and manually find and open this file. I used Atom, and again chose the keep the 
2layer branch version of the conflicted text: 


e 103 


KiCad Like a Pro, Projects, Tips and Recipes 


Figure 11.12.1.8: Resolving another Git merge conflict. 


Save and close the text editor, and return to the command line terminal. Check the Git 
status, and commit the resolved conflicts: 


% git status 
On branch main 
You have unmerged paths. 
(fix conflicts and run "git commit") 
(use "git merge —abort" to abort the merge) 


Changes to be committed: 


modified: MCU Datalogger.kicad_pcb 
modified: MCU Datalogger.kicad_prl 
modified: MCU Datalogger.kicad_pro 
modified: connectors kicad_sch 


Unmerged paths: 


(use «git add <file>...» to mark resolution) 


both modified: .gitignore 
both modified: MCU Datalogger.kicad_sch 


Changes not staged for commit: 
(use «git add <file>...» to update what will be committed) 


(use «git checkout -— <file>...» to discard changes in working directory) 
modified: MCU Datalogger.kicad_prl 
% git add. 
% git commit —am «Fixed bugs in schematic.» 
[main 4f1c810] Fixed bugs in schematic. 
Let's recap before going any further. At this point: 


1. The bugs are fixed in the schematic. 
2. The updated schematic exists in the "main" and "2layer" branches. 
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What remains to be done is to: 
1. Merge the schematic file changes into the "4layer" branch. 
2. Fix the layouts for the 2-layer and 4-layer PCBs. 


Let's do item "1" now and item "2" in the following two segments of this chapter. 


Merge schematic changes into '4layer' 

To merge the changes of the main branch into the 4layer branch (while ignoring the layout 
file thanks to the existence of the ".gitattributes" file), you will use the "merge" command 
while in the 4layer branch. 

When you run the "merge" command, Git will probably ask you for a comment by opening 
up a text editor in your terminal. Type a description of the merge (such as "Bringing fixes 
in the schematic", and save the editor content to return to the terminal. 

Here is my command line session: 


% git checkout 4layer 
Switched to branch '4layer' 
% git merge main 
Auto-merging MCU Datalogger.kicad_pro 
Auto-merging MCU Datalogger.kicad_pr1l 
Auto-merging MCU Datalogger.kicad_pcb 
Merge made by the 'recursive' strategy. 
.gitignore | 3 + 
MCU Datalogger.kicad_pcb | 7980 ++++++++++++++++H++H++H++H+E+H+ H+H EH+EH+EH+E+H+E+H+E+H++H+—— 
MCU Datalogger.kicad_pr1 | 9 +- 
MCU Datalogger.kicad_pro | 6 +- 
MCU Datalogger.kicad_sch | 1668 +++++++++--——————— 
README.md | 5 + 
connectors.kicad_sch | 337 ++— 
7 files changed, 5147 insertions(+), 4861 deletions(-) 
create mode 100644 README.md 


% 


Git was able to merge automatically, and the 4layer branch contains the latest schematic 
version. 

In preparation for the next step, updating the 2-layer version of the PCB with the fix, check 
out the 2layer branch: 


% git checkout 2layer 
Let's continue with the 2-layer PCB layout. 
11.12.2. Fix the 2 layer PCB layout 


You are working in the 2layer Git branch and are about to update the layout file to contain 
the fixes that you initiated in the previous step. 
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Open the layout editor and import the changes from the schematic. The layout will show a 
couple of ratsnest lines resulting from the net label changes in the schematic. I have turned 
off the silkscreen layers to make it easier to work with the cluttered layout. You can use the 
widgets in the Appearance pane to make the editor work more comfortable. 


Feu 
ma  mOse 
w O Fame 
{WO Brut 
Fa O F Paw 
Wy 


la in 


8% @$D4V00 


Figure 11.12.2.9: The two ratsnest lines are the result of the changes in the schematic. 


When I rework a populated layout that is mostly routed, I use the interactive delete tool 
to delete tracks that start or finish on pads that I will need to re-wire. For example, pad 2 
of D1 (the footprint at the top right corner of the PCB) will need re-wiring. I have deleted 
several affected copper tracks in the figure below to make re-drawing easier. 


Figure 11.12.2.10: I have deleted several copper tracks. 
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Draw the new copper traces. Here's the fully-routed instance of my PCB: 


Figure 11.12.2.11: Fully routed, with defects fixed. 


The 2-layer layout is now fully routed. Run a DRC to confirm that there are no errors. In my 
case, the DRC showed two "unconnected end" violations. I chose to address those viola- 


tions by deleting small segments of copper track that I overlooked in earlier work sessions 
with this board. You can see one of those below: 


o DRC Control 


Refill all zones before performing ORC Test for parity between PCB and schematic 
Report all errors for each track 


Violations (2} Unconnected Items (0) Schematic Parity (not run) 


Track [GND] on F.Cu, length 0,3575 mm 
Warning: Track has unconnected end 
Track [Net-(C3-Pad2)] on F.Cu, length 0.3200 mm 


Show; All Eros © Warnings 2 Exclusions 


Delete Marker Delete AH Markers 


Figure 11.12.2.12: Fixing stray copper trace segments. 
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After addressing both violations, I repeated the DRC, which shows zero errors and warnings. 
Save the layout editor file and return to the terminal when you are ready. Check the Git 
status, and commit the changes. Here is my terminal session: 


% git status 
On branch 2layer 
Changes not staged for commit: 
(use "git add <file>..." to update what will be committed) 


(use "git checkout — <file>..." to discard changes in working directory) 


modified: MCU Datalogger.kicad_pcb 
modified: MCU Datalogger.kicad_prl 


no changes added to commit (use «git add» and/or «git commit -a») 
% git add. 
% git commit —am "Fixed 2 layer PCB." 
[2layer 6cc3a84] Fixed 2 layer PCB. 
2 files changed, 2758 insertions(+), 2416 deletions(-) 


The 2-layer PCB now contains the bug fixes. Let's repeat the process for the 4-layer PCB. 


11.12.3. Fix the 4 layer PCB layout 

Let's finish the update process by applying the fix to the 4-layer version of the PCB. 

Close the layout editor if you left it open after finishing work in the 2-layer PCB, then go to 
the terminal and switch your working Git branch to "4layer": 


% git branch 
21l-experimental 
* 2layer 
4l-experimental 
4layer 
main 
% git checkout 4layer 
Switched to branch '4layer' 


% 


In KiCad, open the schematic editor and double-check that you are working with the latest 
schematic version. You should have already imported the latest changes, but I find that 
small "sanity checks" like this can save you a lot of frustration and time if things don't go 
exactly to plan. 

Open the layout editor, and import the schematic changes. As with the 2-layer PCB, you will 
see a couple of ratsnest lines that give you a clue that the import was successful. I use the 
same pattern as before: find redundant or incorrect copper tracks, and replace them with 
new ones. Make your layout editor comfortable to work with by turning off unnecessary 
layers. For the sake of brevity, I present my finished and completely routed instance of the 
4-layer PCB: 
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Figure 11.12.3.13: The fully routed 4-layer PCB that contains the fixes. 


As always, do a DRC before you commit the changes. My DRC revealed similar warnings 
to the 2-layer PCB (stray copper track segments), which I fixed. My last DRC returned no 
errors or warnings. 

Let's finish up by committing the changes to Git repository's 4layer branch: 


% git status 
On branch 4layer 
Changes not staged for commit: 
(use "git add <File>..." to update what will be committed) 
(use "git checkout -- <file>..." to discard changes in working directory) 


modified: MCU Datalogger.kicad_pcb 


no changes added to commit (use «git add» and/or «git commit —a») 
% git add. 
% git commit —am "Fixed net bugs in 4 layer version of the PCB." 
[4layer 9138eb5] Fixed net bugs in 4 layer version of the PCB. 
1 file changed, 7007 insertions(+), 7101 deletions(-) 
% git status 
On branch 4layer 
nothing to commit, working tree clean 


This concludes the work needed to fix the bug that Antti found. Both version of the PCB are 
now up-to-date, with all change history committed to the project Git repository. 
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Part 12: Project - An ESP32 clone 


12.1. Project - Introduction 

Welcome to Part 12 of this book. In the chapters that follow, you will design an ESP32 
development board. To assist you with the design process, you will use the reference sche- 
matic design from Espressif, the original designer and manufacturer of the original ESP32 
dev kit module. 

By working on this project, you will learn to use and modify reference designs. The ESP32 
is a widely used and understood board, and it is compact yet packs significant computing 
power and capabilities. Its circuit board is more complex than those in the previous projects 
of this book but not too complex to make this project long and tedious. 

Below you can see the layout design as it will look at the end of the project. 


Figure 12.1.1: The ESP32 development kit clone project deliverable. 


In this instance of the development kit, I have retained the form factor and shape of the 
original ESP32 development kit. This is a four-layer board with the ESP32 module at the 
top, its integrated antenna extending outside of the board, the power and serial communi- 
cations port at the bottom, and the pin headers along the sides. The board also features the 
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two control buttons, "BOOT" and "EN", and uses SMD components on the front and back. 
Here's a view of the reference layout: 


IHHH 
HHH 
as 8 
wert 
2111 
27.9mm 


48.2mm 


Figure 12.1.2: A view of the ESP32 development kit reference layout. 


Once you understand the design elements of this board, you will be able to modify its shape 
and component placement to match the requirements of your project. For example, in my 
instance of the board, I have chosen to place the voltage regulator in the back of the PCB, 
even though the regulator is the front in the reference design. I did this because I wanted 
to allow more room in the front for small components, like the resistors, to make assembly 
by hand easier. 

Below you can see the final schematic. 
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Figure 12.1.3: The ESP32 development kit clone project schematic. 


Thanks to the ESP32 module's highly integrated design, the board that hosts the module 
(i.e., the development kit) is relatively simple. In the development kit design you see 
above, I have arranged the components in five functional groups, and I have drawn all 
details from the original Espressif reference schematic design. You can see the reference 
schematic design below: 


Figure 12.1.4: The ESP32 development kit reference schematic. 
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You will learn more about this in chapter 2. 
Below you can see the 3D rendering of the development kit. 


Figure 12.1.5: A 3D rendered view of the project deliverable. 


The 3D rendering contains models for all components and is accurate in terms of the ap- 
pearance of the final manufactured board. 

Customizing an existing board begins by finding the original schematic and layout designs. 
In the case of the ESP32 development kit, you can find the official reference designs 
on the Espressif website (https://www.espressif.com/en/support/documents/technical- 
documents). I have used the references design for the ESP32-DevKitC-v4 board. You can 
use the search filter to find this design (or try my search URL "https://www.espressif.com/ 
en/support/documents/technical-documents?keys=ESP32-Devkit"). 


emo < -æ 0 a www.espressi.com/enfsupportlfocuments/technical-documents?keys 
S) ESPRESSIF Products Solutions Support Ecosystem Company JoinUs ContactUs Q Px 
Support > Documents > Technical y 
Q ESP32-Devkit rx} ( Documentation Feeanack | | Subscribe 
= Filter & Cex Found 5 results Expand all + 4 
z Title Version Release Date Download 
ESP32-S3 Series + 
ESP32-S2 Series + + ESPG2-DevKitM-1 User Guide latest 2021.02.24 E 
ESP32-C3 Series + 
š + ESP32-DevKitS-V1.1 Referance 
ESP32 Series 4 Design V1,1 2020.04.08 ul 
ESP8266 Series + 
Other + + ESP32-DevKitS(-A) User Guide latest 2020.03.20 E 
x ESP32-DevKitC-V4 Reference 
Dasign r2.1 
Ordering Information 2020.01.15 
Changed into Schematics, PCB layout, Gerber and 
BOM files of ESP32-DavKitO-V4 
Cartification Info 
Data Sheet + ESPG2-DevKitC Getting Started bo BOATERS cr 
Getting Started Guide 
=f a 


Figure 12.1.6: The source documentation and designs for this project. 
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Download the ZIP file that contains everything you will need for this project: the schemat- 
ics, the PCB layout, and the BOM. The ZIP also contains a set of Gerber files that you do not 
need (you will generate a new set at the end of the project). 

The reference BOM is very important because it gives you all the components and values 
you will need for your custom board. These components and values are tested by Espressif 
and used in millions of manufactured boards, so you can be confident that they will work. 
I used the reference BOM to help me select symbols and footprints for my board instance. 
The project BOM that you see below contains information from the reference BOM. 


Reference Value Footprint 

El, C2521 22uF/10V(20%) Capacitor_SMD:C_0201_0603Metric 

c9, C14, C19, C22 0.1uF/50V(10%) Capacitor_SMD:C_01005_0402Metric 

C15 0.1uF/50V(10%)(NC) Capacitor_SMD:C_01005_0402Metric 

C20 4.7uF/6.3V(10%) Capacitor_SMD:C_01005_0402Metric 

Di LED LED_SMD:LED_0603_1608Metric 

D3 D_Schottky Diode_SMD:D_SOD-323 

D4, D5, D6 D_TVS Diode_SMD:D_SOD-523 

31 USB_B_Micro Connector_USB:USB_Micro-AB_Molex_47590- 
0001 

32,33 Conn_01x19_Male Connectoi-PinHeader-2.s4mm:Pintlead- 
er_1x19_P2.54mm_Vertical 

MOD1 ESP32-WROOM-32 digikey-footprints: ESP32-WROOM-32D 

Q1, Q2 MMSS8050-H-TP digikey-footprints: SOT-23-3 

R2, R24 2K(5%) Resistor_SMD:R_01005_0402Metric 

R7, R18 OR(5%) Resistor_SMD:R_01005_0402Metric 

R11, R21, R22 10K(5%) Resistor_SMD:R_01005_0402Metric 

R23 10K(5%)(NC) Resistor_SMD:R_01005_0402Metric 

R25 22.1K(5%) Resistor_SMD:R_01005_0402Metric 

R26 47.5K(5%) Resistor_SMD:R_01005_0402Metric 

SW1, SW2 SW_Push Button_Switch_SMD:SW_SPST_B3S-1000 

üi a E E Package_DFN_QFN:TQFN-28-1EP_5x5mm_ 
PO.5mm_EP2.7x2.7mm 

U2 AMS1117-3.3 Package_TO_SOT_SMD:SOT-223-3_TabPin2 


Table 12.1.1: The Bill of Materials for this project. 


The BOM shows several SMD components that are very small, such as the 0402 resistors. If 
you plan to assemble your custom board by hand, you should consider the difficulty of work- 
ing with such small components. But, since this is your custom board, you can replace those 
small components with alternatives that you feel are more appropriate for your projects. This 
is just an example of how you can modify a reference design to fit your specific requirements. 
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The main objectives of this project are: 
1. To help you practice skills you acquired in previous projects. 
2. To gain experience in designing a PCB based on an existing reference design. 
3. To gain experience in creating dense, four-layer PCBs. 


I used Snapeda to find the symbol-footprint pairs for MOD1 (the ESP32 module). You 
should be able to find all other symbols and footprints in KiCad's libraries. 
Let's begin. 


12.2. Schematic design 
In this chapter, you will complete the schematic design of this PCB by following the sche- 
matic design workflow. 


12.2.1. Schema 1 - New KiCad project and Schematic Setup 

Let's begin with the new project. Create a new KiCad project, and store its files in a new 
directory. I have named my project "ESP32 Clone Devkit". You can see my new project 
setup below: 


Clone devkit — KiCad 
& Project Files 

[5] ESP32 Clone devkit.kicad_pro 

ir ESP32 Clone devkit.kicad_peb 

B ESP32 Clone devkit.kicad_sch 


‘Schematic Editor 
Edit the project schematic 


9 Symbol Editor 
Edit global and/or project schematic sym. 
3 e... < ESP32 Clone devkit 
PCB Editor 
E Edit the project PCB design Name 
GB ESP32 Clone devkitkicad_pcb 
[l Footprint Editor (D ESP32 Clone devkitkicad_pro $ 


Edit global and/or project PCB footprint + k ESP32 Clone devkit.kicad_sch 


Gerber Viewer 
Preview Gerber files 


Image Converter 
Convert bitmap images to schematic sy 


LL E Y 


Calculator Tools 


Figure 12.2.1.1: Begun a new project. 


Continue to set up the schematic editor. I list my settings below. If a setting is not in the 
list, you can assume that I have not changed its default setting. 
e Page Settings: 
- Issue Date: copied today's date from the date field. 
- Revision: 1. 
- Title: ESP32 Devkit clone. 


Next, review the reference schematic for symbols, footprints, and 3D models that you will 
need to download from an online repository like Snapeda. 

There are three components that KiCad does not have suitable candidates for, and you will 
need to source elsewhere. In the figure below, I have circled the symbols you will need to 
get from Snapeda or the Digikey libraries for KiCad. 
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Figure 12.2.1.2: The circled symbols are not available in the KiCad symbol libraries. 


ee Choose Symbol (18116 Items loaded) 
Q dk_RF-transceiver-modules o key -footprints:ESP32-Y 
tem 
2491 


ATWINC1500-MR210PB 
8C118_1103394 
8C127-1103383 
8L.600-SA 
BLEN12-A-V1 
BLE1I3-A-M256K 
BLETI3-A-V1 
BLET21LR-A-M256K 
BM77SPPS3MC2-O007AA 
BMD-300-A-R 
com-13909 
CYBLE-022001-00 
DWM1000 
MRF24J40MA-1_RM 
MRF24J40MD-I_RM 
MRF24WGOMA-|_RM 
MRFB9XAMOA-I_RM 
NL-SW-EVDO-V_Obsolete [Default] digikey-footprints:ESP32-WROOM-32D | ~ 
NL-SW-LTE-GELS3-C_Discontinued 
NL-SW-LTE-TSVG_Obsolete 
RFD22301_Obsolete 
RFD77101_Obsolete 
RN42-1_RM 
RN42HID-_RM 
RN52-1_RM 
RNI71-L_RM 
RN2483A4-1 RMIOA Discontinued 


ESP32—wROOM—32 


ESP32-WROOM-32 
SMD MODULE, ESP32-DOWDOS, 32MBIT 
Keywords: 1904-1010-1-ND * 


Retorence MOD? 

Footprint digkey-tootprints. ESP32-WROOM-32D 

Datasheet hitos. www espressil comsites'detaul/Wes/documentallo esp32-wro 

Digi-Key_PN 1904-1010-1-ND 

MPN ESP32-WROOM-32 

Catan RENE and REIN 

Select with Browser Place repeated copies Place all units Cancel MI 


Figure 12.2.1.3: Using the ESP32 Wroom 32 module in the DigiKey library. 
First, I need a component for the two pushbuttons. I looked at the libraries that come with 


KiCad for SMD push buttons, but I could not find the exact model I wish to use. After some 
research on Snapeda, I found a suitable model, the B3S-1000P that contains a symbol, 
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footprint, and 3D model. Download the ZIP for this component and expand the archive in 
your project folder in a new "libraries" folder. 

Second, a component for the CP2102N chip that implements the USB to UART bridge. 
While KiCad has a standard QFN28 footprint, it does not have a symbol that matches the 
one used in the schematic design reference. I could spend time to try and compensate 
for the discrepancies, but I decided to spend that time finding an exact match for the 
symbol instead of attempting to rewire the schematic. The component I use in my design 
is CP2102N-A01-GQFN28°. Download it and expand it in the project libraries folder. The 
archive contains all three files (symbol, footprint, 3D model). 

Third, a component for the ESP32 module. I used a symbol and footprint available in the 
DigiKey library. You will find the symbol in the "dk_RF-Transceiver-Modules" group by look- 
ing for "ESP32WROOM-32". 

You can find the DigiKey library for KiCad on Github*®. You can learn how to install it in 
the relevant chapter earlier in this book. I have installed the two Snapeda symbols in my 
Project Specific Libraries tab and the Digikey library in my Global Libraries tab (see below). 


ee Symbol Libraries 


Librarias by Scope 


Glooal Libranes Project Specific Libraries 


K RF-Antannas 

k_RF-Demodulators 

dk_RF-Detectors 
dk_RF-Evalustion-and-Development-Kits-Boneds 
dk_RF-Receivers 


Jusersiperer/Llbrary/Mobile Documentsicom=appie=CioudDocsTech Explor 
JUsers/peter/Llbrary/Mobile Documents/com-apple-CioudDocs/Tech Explor 
JUserajpeter/Library/Mabile Documentafcom-appie-CioudDocs/Tech Explor 
JUserafpeter/Library/Mabile Documenta/com-apple-CioudDocs/Tech Explor 
JUsersjpetes/Library/Mobile Documents/com-apple~CloudDecs/Tech Explor 


dk _RF-Switches 
ck_RF-Transcever-ICs 


JUsers/petet/Library/ Mobile Documents/com-apple-CioudDocs/Tech Exolor 
JUsersipeter/Libeary/Mobile Documents/com-apple~CioudDocs/Tech Explor 
_ Usersipeter/Library/Mo uments/com-appie-ClovdDocs/Tech Explor 
JUsers/peter/Library/Mobilo ocumentsicom-apple~CloudDocs/Tech Explor 
Usera/peter/Library/Mabile Documentsicom-spple—CloudDocs/Tech Explar 
Jiserafpeter/Library/Mabile Documents/com-apple-CioudDocsTech Explor 
Jserafpeter/Library/Mobile Documenta/com-apple-CioudDocs/Tech Explor 
JUsersjputer/Library/Mobile Documents/com~apple-CloudDocs/Tech Explor 
JUsersipeter/Library/Mobile Documents/com~ apple ~CloudDoce/Tech Explor 


dk_RF-Transmitters 
dk_RFIO-RF-Access-Monitoring-ICs 
dk_Rotary-Potentiometers-Rheostata 
dk_Sensors-Transducers_Accessoñes 
d_Shunts-Jumpers 
dk_Signal-Rolays-Up-to-2-Amps 


1SGaaaaBiecaacaaa 
il 


—— 
ee Symbol Libraries 


Libraries by Seopa 


Global Libraries Project Specific Libraries 


re Library Path Library Format Options Description 
[E __|CP2102N-A01-GQFN28 ${KIPRIMOD'Linrarles/CPZTOAN-ACI-GOFNZ@/CPZIOZN-AOI-GOFNZB.ND Legacy 
o B35-1000P SKIPRIMOD/Ubrarios/B35-10D0P/835- 1000P hid Legacy 


Figure 12.2.1.4: My symbol libraries setup. 


9 https://www.snapeda.com/parts/CP2102N-A01-GQFN28/Silicon%20Labs/view-part/?ref=- 
search&t=CP2102N-A01-GQFN28 
10 https://github.com/Digi-Key/digikey-kicad-library 
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Once you have all three of the symbols downloaded and installed continue with step two 
of the workflow. 


12.2.2. Schema 2 - Symbols 

You prepared your schematic editor in the previous segment and installed the three 
third-party symbols. It is now time to add the schematic symbols to the design sheet. Use 
the reference design as an aid when adding the symbols to the sheet. I have arranged the 
Eeschema and PDF viewer windows side by side, as in the example below: 
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Figure 12.2.2.5: Side-by-side arrangement streamlines work. 
I decided to add all large components for this schematic first (starting with the ESP32 mod- 


ule) and then continue with the smaller ones. Below you can see my schematic after I have 
added the main components in the sheet: 
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Figure 12.2.2.6: Added main components to the schematic sheet. 


ceed 
k 


Continue with the smaller components, such as the buttons, the USB connector, LEDs, di- 
odes, and resistors. Here's my schematic with all symbols added to the sheet: 
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Figure 12.2.2.7: All symbols added to the sheet. 


At this point, all schematic symbols should be on the sheet. In the next step of the work- 
flow, you will annotate those symbols. Unlike the practice from previous projects, I rec- 
ommend that you annotate this schematic manually so that your schematic follows the 
designators used in the reference design. If you use the automatic annotator, the chances 
are that your schematic will contain designators that don't match those in the reference 
design. This will make it harder to work in the schematic editor, and you will need to be 
much more cautious as you progress through the copy process. 
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12.2.3. Schema 3 - Annotate and set component values 
In this segment of the chapter, you will manually annotate symbols. While you are at it, you 
will also add the component values. 
In earlier projects in this book, you used the automated annotator tool to quickly generate 
unique identifiers for each symbol. The annotator tool is quick, and because in prior pro- 
jects you did not work off a reference design, you did not have to worry about discrepancies 
between the reference designators in your schematic versus those in the reference design. 
In this project, however, you are using a reference schematic design as an aid for your 
design. Discrepancies in the symbol reference designators can cause you a lot of confusion 
later in the project. Therefore, it is better to ensure that reference designators match be- 
tween your schematic and the reference schematic. 
There are two ways by which you can set values for each symbol: 

1. You can use the Properties window for each symbol individually. 

2. You can use the Symbol Fields Table window and complete this task in bulk. 

3. In the figure below, you can see the Symbol Fields Table window as it will look at the 

end of this segment. I have already populated all reference designators and values: 


e... Symbol Fields Table 
Group symbols T Roference | Value 
v C1, C3 Cat 22ur{slech)WVIZ0%) Capacitor SMD:C_0201_0603Metric 
ico a Vex 22uFisiasti)10V 120%] Capacitor SMD:C_0201_0803Metric - 
Reference ca 22uP{siash) WV (20%) Capacitor SMD:C_0201_0603Metric - 
eed i cat 22uP{slash)KIV(20%] — Capacito_$MD:C_0201_0603Metric 
Datasheet [VES 014, C10, C22) o.1uF{slash;ROV(NIH) — Capacitor_SMD:C_01008_0402Metric > 
Category co O.tuF{slash}50V(10%) Capacitor SMD:C_01005_0402Metric - 
Ego cu O.1UF{slashpSOV 111%) Capacitor_3MD:C_01005_0402Metrnic - 
Description cw O:tuFfslash}BOV(10%) 'Capacitoc_SMD:C_01008_0402Metric - 
Digi-Koy_PN 022 O luFfalash)50V(19%) — Capacitoe_SMD:C_01005_0402Metric - 
ne e crs O.1uF¥slash)S0V(10%) NC} Capacitor SMD:C_01005_0402Metric - 
MAXIMUM_PACKAGE_HEIGHT c20 A JUE (sla3h)j6, 3410) Capacitor_$MD:C_01005_0402Metnc 
o LED LED_SMDEO_0603_1608Metric 
Manutacturer 
PARTREV D3 D_Schottky Diode_SMO:D_SOD-323 E 
STANDARD > D4-D6 os Diode SMO:D_500-523 - 
pasas na USB_B_Micto Connector USB:USE_Micro-AB_Molax_47590-0001 - 
Wadpedia URL > 4219 Cann MIA Male Connector Pirbander_2 BdmemnPinbeader_Jr10_P2 SAmm Vertical S 
moD ESP32-WROOM-32 digikey-Iootprints-ESP32-WROOM-32D httos:/Jwww.espressito 
> 01,02 MMSS80SO-H-TP digivey-toutprints:SOT-23-3 httpsil/mwwimecsemic 
> R2, R24 2K(5%) Resistot_SMO:R_01005_0402Metric - 
> RIT. RIB OR(5%) Resistor_SMO-R_01005_0402Metrlc - 
> RILR2,.R22  10KI5%) Resistor_5MO:R_91005_0402Merric 
R23 1OK(S%)(NC) Resistor_SMO:R_01005_0402Metric 
Add Field... 
Apply, Save Schamatic & Continue Cancel GD 


Figure 12.2.3.8: The Symbol Fields Table, populated. 


However, at the start of this work, the same window looks like this: 
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Figure 12.2.3.9: The Symbol Fields Table, not populated. 


Unfortunately, you can not use the Symbol Fields Table to edit the Reference fields manual- 
ly; you can edit all other fields. Therefore, the only option for manually editing the reference 
designator for each symbol is to use the symbol's Properties window. Since you have to 
open this window manually for each symbol, you can take the opportunity also to set the 
symbol's value field. 

Again, set up your desktop so that Eeschema and the PDF viewer window that contains the 
reference design are side-by-side. I chose to begin from the power supply functional block 
of the schematic and edit each symbol individually. For example, in the figure below, I edit 
the voltage regulator symbol with the designator "U2", following the reference design: 
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Figure 12.2.3.10: Setting the designator of the voltage regulator to "U2". 


Below you can see the Properties window for the voltage regulator. I have just edited the 
contents of the Reference and Value fields using information from the reference design. 


Update Symbol from Library... 


Change Symbol.. 
Edit Symbol... 
Angla 0 8 eae 
Mirror; Not mirrored e Exclude trom bill of materials. 
‘Exclude from Edit Ubrary Symbol... 
Dam oe 
Ubrary link: Reguistor_Linear-AMSIN7-3.3. Spice Model. co « | 


Figure 12.2.3.11: The Properties window for the voltage regulator symbol. 
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Continue with other symbols in the power supply group (resistor, LED, capacitor). Remem- 
ber to add the values as you work your way through the symbols. If this matches your 
working style better, you can choose to leave the values later and edit them in bulk using 
the Symbol Fields Table window. 

Be methodical, and take your time. This is not something you should rush. It took me ap- 
proximately 15 minutes to manually annotate the schematic. Below is the result: 
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Figure 12.2.3.12: The schematic is fully annotated. 


Let's continue to the next step for the workflow, where you will set the symbols in their final 
positions before the wiring in step four of the workflow. 


12.2.4. Schema 3 - Arrange 

You are still working on step three of the schematic design workflow. You have added the 
symbols in the sheet and manually annotated them. In this segment, you will finalize the 
position of each symbol in the sheet so that they are in appropriate positions ahead of the 
wiring step. 

Most of the symbols are close to where I'd like them to be. Most of the work that I had to 
do here was to make small changes to those positions. For example, I aligned resistors 
and capacitors to connect them with straight wire lines later. I also took the opportunity to 
delineate the functional groups with graphical boxes. This is something that I usually leave 
for step seven of the workflow ("comments"), but I decided to do it earlier in this project to 
help me reduce the risk of error as I am working with the reference design. 

Below you can see the schematic as it looked before I started changing the position of the 
symbols: 
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Figure 12.2.4.13: Starting to reposition the symbols. 


Below you see the schematic after I completed this work: 
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Figure 12.2.4.14: Completed the repositioning of the symbols. 
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As you can see, the difference between the first and second versions of the schematic is 
small. However, the newer version is more readable. 

Let' finish step three of the schematic workflow by associating symbols with their footprint 
counterpart. 


12.2.5. Schema 3 - Associate 

This segment will complete step three of the schematic design workflow by associating the 
symbols with their footprints. To do this work, you will need the BOM file that came with the 
reference design archive that you downloaded from Espressif. You will find this file inside a 
folder named "05_BOM List". The file name is "ESP32-DevKitC-V4-(ESP32-SOLO-1)-BOM- 
List(V1.2)-20180621A.xIsx". Below, you can see this file open in Microsoft Excel: 


Home insat Craw Page Leyeut Formule Data Review View 2 Share O Comments 


B c D 


1 
2 [708 De c o ooo H 
3 afi p 
4 a O re (Ceramic Ca 
5 ¡[20 4.7 uPI63V (10%) i 
6 ijoi RED LED light-emitting diode: Red 
7 11D2 ESP-WROOM-32 ESP32-SOLO-1(33V 32 Mbit) 
aj io fam 222] Soo pee o Schotiky Diode, Vrrm-30V, Vr=21V, I-1A, IFSM-5.5A 
3 3/4, DS, D6 LESDSDS0CTIG ESD, TVS Diode, SV 
10 0 Y B Female $ Pin DIP Mitt A Micro USB 
11 201,92 Transistor 
12 2|R2, R24 ae (3%) Chip Resistors 
pemen z pe 
14 2]R17, RIB OR (5%) fso Y Resistor Chip Resistors 
15 1R25 22.1K (3%) 0402 Resistor Chip Resistors 
16 I[R26 47.5K (5%) Resistor [Chip Resistors 

z 3 Muted. 2H 3x4x2, WE 
17 2/5W1, 5W2 Pr pentane ees (reset button, 2-pin, 3xtx2, SWT) 
18 2[12,33 [CONI9X1_2P54 [Connector [Male PCB Single Row Straight Header Connector, 2-54 mm Pitch, 19 Pins 
19 UL CP2102N-A01-GQFN28 Q Interface ICs USB-10-UART, USE2.0 full speed, data mte up to 3M band 

LDO, SV $€ 3.3V RER, 1A, SOT-223 

20 1u2 AMS1117-3.3 Power ICs (LDO, $V/3.3V, LA, SOT-223) 
21 


ESPI2-DevKnC-Ve BOM + 


ove SSS 2) -—— — + woe 


Figure 12.2.5.15: The reference design BOM file. 


Use the information in column E of the BOM file to find the appropriate footprint. For ex- 
ample, for capacitor C1, the reference design recommends the 0603 package for a ceramic 
capacitor. In implementing this board, I have followed the reference design recommenda- 
tions. 

In Eeschema, use the Footprint assignment window to make the associations in bulk. If you 
prefer, you can also use the Properties window for each symbol (a more time-consuming 
option). 

I recommend that you take some time to browse through the footprint libraries on your 
own until you can find the required footprints. If you need to, you can consult the BOM table 
to introduce this project. You will find the complete list of footprints that I have used there. 
Below you can see my completed associations table: 
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eee Assign Footprints 
1B +» D © BS roim: £35 £6 fa 
cillater 6 C19 = 0,luF(clash)S0Y (104) : Capacitor_SMD:C_01045_ IMUIMetric 2 Package _DFN_OFW:QFM-28-12>_FxGmm PQ. Sem EP1,7:4.J300, Tharma VI 
c kaga BCA 7 (20 = 4.7uF{plash6.3V(10%) + Capacitor SNO:C e402 1ANSMot ric 3 Packago DFN QFN: DFM-28-JEP_dxdem Mdm EP? 3x2. 300 
chage CSP a C21 ~ 22uF (slam) 1041104) 1 Copacitor_SMD:C_0201_0683Metrie 4 Package DPLGFR:QFH-28-16° dxdes_M. dom EP2.3x2.30m, ThorsalVia 
¡Chunpt_DFM_0EN , C22 — 0, Sur islam SOV(104) : Caphcitor_5MD:C_61005_VagiMetric S Peckage_OFN_OFW:0FN-20-187_ 4idem_ PO. dan EP2.4x2.40m 
tac hege DIP 3+ 9- LE) ; LED SND:LED 0603, 1600tetric 6 Pachage_DFN_QFN: OFN-~25-1EP_4x4em_P@.4em_£P2.4x2.40m Thersatvis 
ochage DirectFET u 03 - D_Schotthy ; Dioda_90:0_$00-323 7 Package DIN OFN: OFN-28~167_Aa4em_ PA. dem £72,622. em 
ckope LCC n ^- D_TVS + Diode S0:0_500-523 © Packsge_DFN_OFW: ON-20-1EP Arden Po. dan EP23. 6x2. tan ThersalVis 
ekwpe LGA v 0- D_IVS + Diode_90;D_500-523 S Pochoge OIN OPW: DPN-20-18P_dxdew_ PO. tien EP2. 4x2. dem 
'ackage_ ger u %6- OLIVE t Diode 9%9:0_500-523 10 Package_DM_QMN:0MN-20-18P_4xden_P0. 43an _EP2. 0x2. dan ThermalVi 
ckage_ SIP 3 n- USA A Micro : Connector VSA:USU Micro-AN Noles 47590-0001 11 Package_OFW_OFN: OFN-28~18?_4x3ee_PO.Sem_CF2,05x3. 650m 
ckage_50 1 J2- Comn_01x19 Male Connector PinNeoder_2. drei Pinesder_1x13_ 2.341 12 Pockage_OPN_OFN:OFN-20-1EF_AxSex_PO.Sem_0P2.05x3.65ee_TheranlY 
¡ckage_50_)-Lend v 33 - Conn ind Male + Connector_PinWender_2,S4re:PirMeader_1x19_P2.%41 13 Package OFN OPNIOPN-25-18P_Sa50m_P. Sam EFI, 3503. 30m 
ckape SOM 1 MOD1 - — ESPIZARDON-21 : digikey-tootprints:£SPI2-WRO0M-220 14 Package DFN OPN:OPN-28-18P_S5em_PA,Sam_EP3,353.330m_Theran Y 
ickage_ TO_SUT_SMO 19 a- MMSSBOSE-H-T? 1 digtkey-footprints:SOT-23-3 15 Package_DFM_OFN:OFN-28-18P_Sx6ex_PO.San_EP3.65x4.65em 
ichage_TO_SOT_THT 2 Q- MMSSSOSE-H-T? 1 digikey-feotprints:5or-23-3 16 Pachage_DFN_OFRIQFN-~28~1EP_SaGem_PO.Sam_EP3.65x4.65em_Theraaly 
ters sample library a R- 2KISS) : Resistor SMD:A_01005_0403Netric Y Pachage DFNLOFN:]FN-2B-IEP_êx6en_ PA. 630m _EF4, Bx¢. Smm 
tent ioneter SO a all TOK(SS) 1 Resistor_SMD:R_01005_M02Motric * Package_DFN_QFNIQFN-28-1EP_SxGem_PA.SSem_EP4. 8x4. nm _Theraal¥i 
tent ioneter THT a RIT = ORISA) : Resistor_SMD:N_ML005_044 Metric 19 Package DFN QFN: QFN-28-1EP_SxGem_PO.SSem_EP4. 2504. 750m 
olay SD Mm Ris ORISA) © Mosistor_SMD:M_M1605_DAB2Motric 20 Package DFW_OQFW:OFN-20~1E>_GxGmm_PO.6Sem_EP4. 25x4. 250m_Tharmal: 
wlay THT 25 R21 ~ 10 (50) + Mosistar SPO:M_01805 e4erWerric E wage QFN: TOPN-28-1EP_SxSee_PB. Sem_EP2 P3 
pistor SHO 2% RnR - IKIGA) : Resistor_SMD:A_01005_002Merric 22 Pachange DFN OFN: TOFN-28-1P_Sx5ua_PO. Sem EP? 7x2. Jem Thermo lvl 
esistor THT o xn - VOX (SA) ONC) = Mesistor_SMD:M_01005_MU2Metr ic Z) Pachage_DFN_QFN:TOFM-28-187 Sañan PR San EP3, 2513.7500 
a a- IKLIN) + Mesistor_DMD:R_01005_DA0Metric 24 Packege DPN QFN: TQFN-28-1P SxSee_ MM San EPI. 2523.250 Thermal 
Antenna » R25 - 22, 1K(98) + Resistor_W7R_e1ees_SeoMet ric 25 Packsge_DPM_OFW: Taxus A-PWOFN-N2U_EF2. 1:3, tom 
P_Converter R20 - 47,.9K(58) + Resistor _SiOsR_O1005_HeSMet ric 20 Package DPN OFN: Tenas A-PWOFN-N20_EP?. 1x3. tem Therma lv ies 
GPS n si- Si Push 1 Sutton_Switch SD) SW_SPST_835-1008 27 Pockoge DPN OIN: UQPN-28-1EP_ArAna_ PO. inn EP22. 35x2. Sewn 
Ea n WM- SW _Push 1 Button Switch SMD: SW_5PST_835-1000 20 Packege DEN OPN: UQPN-25-1EP_ixden PO, inn EP2. 35x2. Sem Thermal 
Wani-Carcuits a UI = CP21824-M01-G0FNZE $ Package_DFN_OPNITOFN-28-1EF_5ximn_ PO. 5em EPZ.) 29 Packope_DPM_OFN: VUPN-20-1ŁP_4xdms_ PO, 450m EPZ. 4x7, Arm 
IF Module uM u- ARS1I17-3.3 1 Package_TO_SOT_SHD:SOT-223-3_TabPin? 30 Package DFN OFN: YOFN-20-1£P_4x4ea_P0. tom EP22. 4x2, dan Theranly 
F_Shielsing 
Finered by Pin Count (29), Library (Package_DFN_OFN): 32 
Schematic saved 
Library location: /Volenes/RAID/Kicad Projecta/Librankiced/modules/Packege DFN_OFN. pretty 
‘Apply, Save Schamatic & Continue Cancel =D 


Figure 12.2.5.16: The completed associations table. 


If you cannot find any of the footprints, especially those from Snapeda and Digikey, ensure 
that you have correctly installed the necessary libraries. 
Once you have completed the associations, continue with step four of the workflow: wiring. 


12.2.6. Schema 4 - Wiring 

With the help of the schematic reference from Espressif, wiring your schematic should be 
straightforward. You have already placed the symbols in their functional groups. As in pre- 
vious projects, the strategy is to use graphical line wires to connect pins within the same 
functional group and net labels for everything else. 

Place the Eeschema window next to the PDF viewer with the reference design, and start 
wiring. Below you can see the completed wiring for the first functional group, the power 


supply: 


Power Supply 
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AMS1117-3.3 
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A 

Figure 12.2.6.17: Power supply group wiring is complete. 
Left: my wiring. Right: reference. 
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Continue with the switch buttons: 


Switch button 


swi 
SW_Push 


GND 6 


O SF 


L iog EN 
c15 C14 
1uF/50V(10%)(NC) D.duF//50V(10% 

ND 


— 


SW2 
SW_Push 


aami 


5225 


Figure 12.2.6.18: Switch buttons group wiring is complete. Left: my wiring. Right: 


reference. 


Next up, the connectors. Use net labels for all wirings. 


J2 
sone EE Wiss 


se 
73 SENSOR_VP 
~ 4 SENSOR_VN 
5 1034 
6 1035 
7 1032 


J3 
Conn_01x19_Male 


8 1033 
9 1025 


Figure 12.2.6.19: Connectors group wiring is complete. 
Left: my wiring. Right: reference. Not showing reference for J2. 


Next, the ESP32 module group: 
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Figure 12.2.6.20: ESP32 group wiring is complete. Left: my wiring. Right: reference. 


Finally, the Micro USB group. This is the most complicated part of the schematic: 


as 
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| a 
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CP2102N-A01-GOFN2| 


Figure 12.2.6.21: Micro USB group wiring is complete. Left: my wiring. Right: reference. 


Here is the schematic, with wiring complete: 
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Figure 12.2.6.22: Schematic wiring is complete. 


Let's continue with part five of the workflow. You have already created the nets, so what is 
left is to create the net classes and associate them with nets. 


12.2.7. Schema 5 - Nets and Net Classes 
In the wiring step that you completed in step four of the workflow, you used net labels 
alongside graphic wire lines. As a result, you have already created all required named nets. 
Therefore, to complete step five of the schematic design workflow, you only need to set up 
the net classes and associate nets with those classes. 
In addition to the default class, go ahead and create three more classes. In each class, 
assign the nets that I list below: 

e Default (already exists): assign all net except those listed below. 

e GPIO: All IOxx nets. 

e POWER: EXT_5V, VBUS, VDD33, GND. 

e USB: RXD, RXDO, TXD, TXDO, USB_DN, USB_DP. 


Below is my schematic setup window showing the four net classes with some of the net 
allocations. 
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ee Schematic Setup 
General Net Class Wire Thickness: Bus Thickness: Color Line Style 
ote ot824mm 052a mm — 
Field Name Templates TER : rn ~ 
Electrical Rules GPIO 0.1524 mm 0: mm = Solid 
Violation Severity POWER 0.1524 mm 0.1524 mm meee Solid 
Pin Conflicts Map USB 0.1524 mm 0.1524 mm — Solid 
Project 
Text Variables 
+ C Set color to transparent to use Kicad default color. 
Fitter Nets Net | Not Class 
Net class fitter: IRI Default 
Net name filter: ¡RTS Default 
IRXD USB 
Show All Nets Apply Filters IRXDO USB 
/sDO Default 
Assign Net Class 1SD1 Default J 
New net class: Default 1502 Default 
{SD3 Default 
Assign To All Listed Nets Assign To Selected Nets ISENSOR_VN Default 
{SENSOR_VP Default 
[mxo USB 
muna nea 
Import Settings from Another Project... Cancel 


Figure 12.2.7.23: My net class setup. 
Let's continue with the Electrical Rules Check. 


12.2.8. Schema 6 - Electrical Rules Check 

Time to do the Electrical Rules Check. I usually forget a few simple things, like annotating 
GND or power labels. My ERC window indicates that I have not fully annotated the sche- 
matic. The non-annotated symbols are the GND symbols. I don't need to annotate those 
symbols manually, so I will use the annotator tool and automatically annotate them. 

With the schematic fully annotated, re-run the ERC and click on Run ERC. The checker re- 
ports three errors and one warning: 


o o Electrical Rules Checker 


Messages Violations 


v Input Power pin not driven by any Output Power pins 
Symbol U2 [AMS1117-3.3] Pin 3 [VI, Power input, Line] 
~ Input Power pin not driven by any Output Power pins 
Symbol U1 [CP2102N-A01-GQFN28] Pin 8 [VBUS, Power input, Line] 
~ Unconnected “no connection" flag 
No Connect 
~ Input Power pin not driven by any Output Power pins 
Symbol MOD1 [ESP32-WROOM-32] Pin 2 [3V3, Power input, Line] 


Show: All Errors o Warnings 1 Exclusions Save... 
Delete Markers Close 


Figure 12.2.8.24: The ERC report. 
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The first two errors indicate that two pins marked as "input power pins" are not connected 
to an "output power pin." To fix this error, attach POWER_FLAG symbols to the affected 


nets. Below you can see the fix for the first error: 


Messages violations 


~ Input Power pin not driven by any Output Power pins 

Symbol U2 [AMS1117-2.3] Pin 3 [VI, Power input, Line} 
Input Power pin not driven by any Output Power pins 

Symbol U1 (CP2102N-A01-GQFN28) Pin 8 (VBUS, Power input, Lane) 
~ Unconnected "no connection” flag 

No Connect 
nn A v Input Power pin not driven by any Output Power pins 
Symbol MODI [ESP32-WROOM-32] Pin 2 [3V3, Power Input, Line] 


Lov(20%) 


i cy) ———_ ñ 
Figure 12.2.8.25: Fixing an "Input Power pin not driven by any Output Power pins" error. 


Fix the second and fourth errors in the same way. 
The third error (actually, an "Unconnected no connection warning") is unusual but easy to 


fix. See this error below: 


GPTU.D 
Messages Violations 
Y c + Input Power pi driven by any Output Po i 
SUSPENDB Sobol? [Aus 33} Pins Ii ewe moa, rel 
~ Input Power pin not driven by any Output Power pins 
h Symbol UI [CP2102N-A01-GQFN28] Pin 8 [VBUS, Power | h i} 
SUSPEND _ Semel eran Aot cons np, Line 
No Cannect 
~ Input Power pin not driven by any Output Power pins 
Symbol MODI [ESP42-WROOM-32] Pin 2 (349, Pawar input, Line} 
CHR1 
CHRO 


CHREN 


Show: All Y Eros @ Y Wamings 1 Exclusions 


Delete Markers Close) 


Figure 12.2.8.26: An unusual "Unconnected" warning. 


The origin of this warning is that the ESP32 symbol pin 10 (with the name "NC") already 
has an "unconnected" symbol attached to it. I did not notice this when I added a second 
unconnected symbol on top of the original. Delete the "X" symbol on pin 10, and run the 
ERC once more. Here is the result: 
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Figure 12.2.8.27: Fixed last warning. 


Let's finish the schematic design workflow in the next segment of this chapter, where you 
will add additional comments to the schematic. 


12.2.9. Schema 7 - Comments 

You have already done most of the commenting work earlier in the process. The schematic 
design contains boxes to enclose the functional groups, and those boxes have names. 

The reference design contains a truth table for the DTR and RTS signals, and I'd like to 
include that in my schematic using a text box. Below, you can see the truth table in the 
reference design (right) and the location I'd like to place it in my design: 


APT) Dee tome [POPE 


Gee will o ERE NCAA SEN OETA et fy 
SOONI PU CAARAgE! 24ra RADA L T Malo 
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Fenn Eg 


Figure 12.2.10.28: The truth table in the reference schematic. 
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Below you can see the text label that contains the truth table text and its location in my 
schematic design: 


USB 
R24 USB_DN 


"ag a2 
cae CÍA MMSS8050-H-TP 


Figure 12.2.10.29: The truth table in my schematic design. 


Another improvement I'd like to make is to reduce the size of the component value text. 
The default size is too big, causing for text to spill over other elements of the schematic, 
like in the example below: 


Switch button onno 
| | 


H 
Vina | swi SW2 


v(20%) 
E 
i 
E 


ra] 
ul 
2” 
” 


224F/10V(20%) 


.AuF/50V(10%)(NC) D.1uF/50V(10% 


SNE AP A AAN Es 


Figure 12.2.10.30: Value text is too big. 


To change the size of all value text elements, use the "Edit Text & Graphics Properties..." 
tool from the "Edit" menu. Set it to change all "Values" to "Text size" "1 mm": 
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ee Edit Text and Graphic Properties 

Scope Faters 

Reference Filter other symbol fields by name: 

© values 

Other symbol fields Filter items by parent reference designator: 

Filter items by parent symbol library id: 
RESA Filter items by parent symbol type: Non-power symbols E 
spite Filter items by net: 

Hierarchical labels 

Sheet titles Only include selected items 

Other sheet fields 

‘Sheet pins 

Sheet borders & backgrounds 

‘Schematic text & graphics 

Set To 

Text size: mm © Bold 

ico: ~ leave unchanged -~ E) © talic 

H Alignment (fields only}: — -- leave unchanged ~~ © Visible (fields only) 

Y Alignment (fields only): -- leave unchanged -- Ej 

Line width: -- leave unchanged ~~ mm Line color: 

Line style: ~- leave unchanged -- Sheet background color: 

Cancer UND 


Figure 12.2.10.31: Changing size for all Value text elements. 


This change will allow value text elements to better fit in the available space: 


EN 


Qi 
MMSS8050—H-TP 


q2 
MMSSB050-H-TP 
100 


10K(5X) 


Auto 
DTR 
1 


0 
1 
0 


rogram 
TS-->EN 100 


hoon 


Power Suppl 


PWRFLAG 


U2 
ANS1117-3.3 


2K(5x) 22uF/10V(20%) 


D1 


no 


Rd nor E 


c3 


22uF/10V(20x) 


Switch button 


1 

Swi SW2 | 

SW Push SW Push | 

100 EN | 

c15 C14 | 

| Aur /SOV(L0X)(NC) oj1ur/5ov(10%) | 
j | 
GND ool O O 


Figure 12.2.10.32: Value text fits better. 
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This completes the schematic design workflow. Let's continue with the layout. 


12.3. Layout design 

In the previous chapter, you completed work on the schematic design of the ESP32 devel- 
opment kit clone. You are now ready to begin work on the layout design. 

Before you start work in Pcbnew, take a few minutes to review the objectives of the layout 
design workflow. 

The main objective is to design an ESP32 development board that can fit in a mini bread- 
board. It will have a simple rectangular shape, with two pin rows along the long edges and 
the USB connector at one of the narrow edges. Below is the 3D rendering of the board that 
I designed as I worked on this project: 


Figure 12.3.1: The main objective of this project. 


Below is the layout of the board, as it looked when I finished work on it: 


Figure 12.3.2: The PCB as it looks in the layout editor at the end of this project. 
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There are two main geometrical constraints: 
1. Minimize the board's size to minimize its cost. 
2. Ensure that it will fit in a double mini-breadboard. 


In the photograph below, I show a measurement that I took that shows the required dis- 
tance between the pin rows: 


Figure 12.3.3: Measuring the distance between the rows. 


Based on this measurement, I will design the PCB so that the distance between the rows 
is approximately 27 mm. This will allow me to use my ESP32 development kit with two 
mini-breadboards combined, as in the photograph above. 
In addition to the above, this project's layout design will allow you to practice: 1. 
Working with differential pairs. 

1. Working with components on both sides of the board. 

2. Adjust the default design rules to allow small components that otherwise would 

cause violations. 


Let's begin by setting up the layout design editor. 


12.3.1. Layout 1 - Setup 
Let's set up the layout editor to match the requirements of the work ahead. 
Open the Board Setup window and edit the following settings (if I have not listed a setting 
below, leave it at its default value): 
e Board Stackup. 
- Physical Stackup. 
- Copper layers: 4. 
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Board Editor Layers: 
- F.Cu: mixed. 
- In1.Cu: mixed. 
- In2.Cu: mixed. 
- B.Cu: mixed. 
Text 8 Graphics. 
- Defaults. 
- Silk Layers. 
- Line Thickness: 0.15 mm. 
- Text Width: 0.8 mm. 
- Text Height: 0.8 mm. 
- Text Thickness: 0.1 mm. 
Design Rules. 
- Minimum track width: 0.1 mm. 
Net Classes. 
- GPIO and USB. 
- Clearance: 0.1 mm 
- Track Width: 0.1 mm 
- Via Size: 0.5 mm 
- Via Hole: 0.35 mm 
- uVia Size: 0.25 mm 
- uVia Hole: 0.1 mm 
- DP Width: 0.1 mm 
- DP Gap: 0.15 mm 
- Assigned nets GPIO: all IOxx nets. 
- Assigned nets USB: RXD, RDXO, TXD, TXDO, USB_DN, USB_DP 
- POWER. 
- Clearance: 0.1 mm 
- Track Width: 0.15 mm 
- Via Size: 0.6 mm 
- Via Hole: 0.4 mm 
- uVia Size: 0.25 mm 
- uVia Hole: 0.1 mm 
- DP Width: 0.2 mm 
- DP Gap: 0.25 mm 
- Assigned nets: EXT_5V, VBUS, VDD33, GND 
- Default: 
- Clearance: 0.1 mm 
- Track Width: 0.15 mm 
- Via Size: 0.6 mm 
- Via Hole: 0.35 mm 
- UVia Size: 0.25 mm 
- UVia Hole: 0.1 mm 
- DP Width: 0.1 mm 
- DP Gap: 0.15 mm 
- Data: will setup later. 
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I have reduced the sizes for the GPIO and USB net classes because some of the board 
components are so small that the default design rules would trigger multiple clearance vio- 
lations. In the example below, the arrows point to resistors that use the 0402 package. To 
prevent clearance violation errors from occurring, I have changed the minimum clearance 
for members of the GPIO class to 0.1 mm. 


Figure 12.3.1.4: Small components require smaller clearances in the design rules. 


Similarly, this board contains a couple of differential pair tracks. Those differential pairs 
are located in the top left of the board, between the ESP32 module pads and the pins row. 
Because the distance between the pads is very small, I had to reduce the clearance of the 
differential pairs in the design rules. 


\ 


i 1 ; 3 
-JSU GND 


D6. 


Figure 12.3.1.5: Differential pairs require adjusted clearances. 


Finally, setup the editor page in the Page Settings window: 
e Page Settings. 
- Issue Date: copy today's date. 
- Revision: 1 
- Title: ESP32 Custom Dev Kit 
- Save your work, and continue to step two of the layout workflow. 
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12.3.2. Layout 2 - Outline and constraints 

Let's continue with Step two of the layout workflow. Here, you will draw a rough outline 
of the board in the Edge.Cuts layer based on the constraints I described in the setup step. 
The primary geometrical constraint is to design the board so that the two pin headers are 
approximately 27 mm apart. This will allow the board to plug into a double mini-bread- 
board. In the photo below, I show my caliber measuring the distance between the two rows 
where I want to place the pin headers: 


Figure 12.3.2.6: The main geometrical constraint is the 
distance between the pin headers. 


The measurement I took with my caliper, 27 mm, contains some tolerance so that I can 
vary it in the design. From my experimentation, I found that a distance between 26.90 mm 
to 27.10 mm is acceptable. In my design, I will aim to the middle of this range. 

Start by importing the footprint in the editor using the "Update PCB from Schematic" tool. 
You can see my editor window below with the bundle of the footprints just imported: 
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Figure 12.3.2.7: Imported footprints from schematic. 
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Since the geometrical constraints call for a specific distance between the two pin headers, 
I will use them to draw the rough outline of the board. Consult the reference design to find 
the correct side for each pin header. Header J2 should go to the left side and J3 to the right 
side. 

Take footprint J2, place it towards the middle left of the editor, and lock it. You will use J2 
as an anchor to measure a distance of approximately 27 mm from the second header, J3. I 
have set my grid size to 0.127 mm. In the figure below, I have set J3 to be 26.92 mm away 
from J2. Notice the dx and dy values in the bottom status bar and the grid size. A reminder: 
to reset the dx and dy counters, press the space bar. 


*ESP32 Clone devkit — PCB Editor 


EA a oa E B ¿$ F.Cu(Pgup) x YA T5 


Grid: 0,1270 mm {0.0050 in) BF 2oomanto B 


zar  x1041240 Y 723900 de 28.9240 dy 0,0000 dht 85240 iid X01270 ms Y Oot 


Figure 12.3.2.8: Setting J3 26.92 mm away from J2. 


In the figure below, I have completed the placement of J3 and locked it in place. I then used 
the measurement tool to insert this measurement in the User.1 layer: 


26.9240 mm 


Hvonn 


Figure 12.3.2.9: Pin header placement is complete. 
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Ensure the J2 and J3 are locked. Do a sanity check"! and confirm that the ESP32 module, 
the board's largest component, will fit between the two headers. As you can see below, it 
will: 


a 
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da 


Figure 12.3.2.10: Centering the ESP32 module between the pin headers. 


To ensure that the ESP32 module is centered between the pin headers, select all three foot- 
prints, right-click to open the context menu, and select "Distribute Horizontally" from the 
"Align/Distribute" menu. Also, shift the ESP32 module upwards to extend the antenna area 
outside the mainboard area. This ensures that the antenna circuitry is away from potential 
interference from other board electronics. 

Lock the ESP32 module. 

You can see the current state of the board below: 


qu TTT TTT My 


ESP32-WROOM-32 


Figure 12.3.2.11: The first three footprints are locked in place. 


11 https://en.wikipedia.org/wiki/Sanity_check 
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Now that you have the footprints that define the shape and size of the board, you can 
proceed to draw the rough outline. Change the grid size to 0.254 mm, enable the Edge. 
Cuts layer, and choose the rectangle drawing tool. Below you can see the rough outline, in 
orange: 
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Figure 12.3.2.12: Completed the rough outline of the board. 


Continue in the next segment where you will place the rest of the board footprints inside 
the rough outline. 


12.3.3. Layout 3 - Place components 

Continue to move the rest of the footprints within the rough outline. Move the footprints 
close to the board outline to make them easily accessible. At the start of the placement 
process, my editor looks like this: 
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Figure 12.3.3.13: Beginning of the footprint placement process. 
You can use the reference design to help with the appropriate position of each footprint, 


but also remember that you have the freedom to vary. You can see the reference design 
tomorrow: 
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Figure 12.3.3.14: The board reference design. 


In the figure above, I have used yellow circles to mark a few very closely positioned com- 
ponents. This is not a problem in the reference design since an assembly machine will 
manufacture the board. However, I plan to assemble my board by hand, and such packed 
positioning will make hand assembly very difficult. 
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Instead of following the reference design blindly, I chose to make a variation. I decided to 
place the voltage regulator and USB-UART bridge in the back of the board. This will release 
much of the front of the board to space out the small capacitor and resistor footprints, 
which will make assembly easier. 

I have decided to place other components, such as the buttons and the USB connector, as 
they appear in the reference design. 

Continue with the USB connector (J1) and the buttons (SW1 and SW2). Use KiCad's align- 
ment tools to center and justify the footprints. Lock J1, SW1, and SW2 in place. Below is 
my layout at this time: 


Swi 


Q 
|O fal lo 
SW_Push 24- SW_Push | | E 


Pa 


O 
Figure 12.3.3.15: Completed placement for J1, SW1 and SW2. 
I have decided to place U1 and U2 in the back of the board. Position them close to the front 


of the board (where the J1 connector is). To place a footprint in the back of the PCB, select 
"Back" in the Side field of the footprint's properties window: 
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D o Footprint Properties 
General Clearance Overrides and Settings 3D Modeis 
Text Items | Show Width Height Thickness | italic Layer 
Reference designator U2 1 1 0.15 O £ Silkscreen 
Value AMS1117-3,3 1 1 0.15 O F Fab 
${REFERENCE} 0.8 08 0.12 o F.Fab 
Ez E 
Al Hace Update Footprint from Library... 
x 88.9 po © Unlock footprint : 
Lock footprint Change Footprint. 
Y: 97.028 mm 
Edit Footprint., 
Side: Back [5] 
Auto-placement Rules Edit Library Footprint.. 
Orientation 
Allow 90 degree rotated placement Fabrication Attributes 
000 
90.0 o 0 10 Component: SMD 8 
-90.0 a on Not in schematic 
Allow degree rotated placement: 
180.0 Exclude from position files 
Other 0.000 o 0 10 Exclude trom BOM 
Library link: Package_TO_SOT_SMD:SOT-223-3_TabPin2 Cancel PA 


Figure 12.3.3.16: Placing a footprint in the back of the board. 


Lock U1 and U2 in place. At this time, my layout looks like this: 


“Male 5 5 


Figure 12.3.3.17: Blue: back layer. Red: front layer. 
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Ensure that the courtyard lines (purple or light blue lines around the footprints) do not 
intersect with other lines and are not outside of the orange board outline. Courtyard lines 
indicate the border of a footprint. 

Continue with the transistors Q1 and Q2. Always align and justify, and lock in place when 
finished. 
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Figure 12.3.3.18: Placed Q1 and Q2. 


Finally, continue to place the small footprints: LEDs, resistors, capacitors. These footprints 
will go in the free space between the buttons and the ESP32 module. To reduce clutter, 
disable the back layer visibility. Here is what my editor looked like before I began work: 
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Figure 1 12.3.3.19: Propano to place the small footprints. 
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During placement, observe these guidelines: 
e Use ratsnest lines and place footprints with pads near their closest connection. 
e Place footprints in groups: place resistors close to other resistors and capacitors 
close to other capacitors. 
Avoid mixing footprints of different types as this will increase the risk of errors in 
assembly. 
Justify and align frequently. 
e Space out as much as possible so that you make use of all available space. This is 
very important if you plan to assemble the board by hand. 
e Take as much time as you need to produce a high-quality design. Fixing it later will 
be costly. 
You can see my small footprint placement below: 
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Figure 12.3.3.20: Completed placement of small footprints. 


The footprint placement is now complete: 
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Figure 12.3.3.21: Showing final placement of all footprints in the front of the board. 


In the next segment of this chapter, you will return to step two of the layout workflow and 
refine the board outline. 


12.3.4. Layout 2 supplemental - refine outline 
You have completed the placement of all footprints in the front and back of the board. You 
can now give your board its final refined shape. As you have done in previous projects, the 
refinement will consist of two changes to the rough outline: 

1. Replace all 90-degree corners with aesthetically pleasing rounded corners. 

2. Remove substrate material that is not necessary. 


This is what the board looks like at the moment: 
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Figure 12.3.4.22: Plan to refine the rough outline. 


I will replace the corners "1" and "2" in the figure above with rounded corners. At the top 
of the board, there is un-utilized substrate material in corners "3" and "4". I will remove 
those, and I believe removing this material will make the board look more modern and 
streamlined. 

Use the process that you learned in the previous projects to do the refinement work. 

As I drew the refined outline, I made several errors that caused problems with the 3D view- 
er and the DRC. I list some of those errors below. 


Text labels 

The DRC will complain when a text label in the silkscreen overlaps with other elements or 
outside the board outline. See the example below, where the label "MOD1" is outside the 
board, and J3 is outside the board and overlaps with other elements. 
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Figure 12.3.4.23: Text label bugs. 


To fix such errors, move the labels inside the board outline and ensure that they don't 
overlap with other elements (this was my choice for MOD1). You can choose to make them 
invisible (this was my choice for J2 and J3). 


Malformed courtyard 


Courtyard lines should form a closed polygon (same applies to lines in the Edge.Cuts layer). 
In the example below, the courtyard line from the ESP32 module footprint is malformed. 


Figure 12.3.4.24: Courtyard line bug. 


To fix this, you have two choices: 
1. Delete the footprint's courtyard (my choice). 
2. Redraw the courtyard to ensure it forms a closed polygon. 
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I chose option one as it is easier and faster. I am mindful that the DRC will not be able to 
use the courtyard to let me know of overlap violations. But, as I have already placed all 
footprints on the board, I don't expect any related problems. 

To delete or redraw the courtyard lines, you need to use the footprint editor. 


Edge.Cut errors in footprints 

Footprints may contain errors, and this is why it is important to recognize them and fix 
them. In this project, the footprint I used for the USB port contains an open polygon drawn 
in the Edge.Cuts layer (see below). 


Figure 12.3.4.25: Open polygon graphic in the Edge.Cuts. 


The 3D viewer will show an error if it detects an open polygon in the Edge.Cuts layer. Your 
PCB manufacturer may also have trouble dealing with this and may ask you to fix the layout 
and re-submit the Gerbers. 

To fix such errors, you will need to edit the footprint in the footprint editor. I chose to delete 
the original drawings in the USB connector's footprint. 


Clearance violation 

In using the DRC to help me fix drawing bugs, I found a clearance violation relating to the 
pads of the small capacitor and resistor footprints. These footprints belong to the Default 
net class, and their minimum clearance is set to 0.2 mm. 

You can see some of the violations below: 
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Figure 12.3.4.26: Pad distance violates minimum clearance. 


I use two arrows to point to the pads of C14. Those pads are 0.1 mm apart when the min- 
imum is 0.2 mm. To fix this error, you have a few choices: 
1. Change the minimum clearance for the Default class to 0.1 mm. 
2. Make the nets to which the affected pads belong members to the GPIO net class. 
3. Create a new net class with a minimum clearance of 0.1 mm, and make the affect 
pads members of the new class. 


I decided to go with the third option and created a new net class named "Data." 
e Data. 
- Clearance: 0.1 mm 
- Track Width: 0.1 mm 
- Via Size: 0.5 mm 
- Via Hole: 0.35 mm 
- uVia Size: 0.25 mm 
- UVia Hole: 0.1 mm 
- DP Width: 0.1 mm 
- DP Gap: 0.15 mm 


Assign these nets to the Data net class: 
e CDC 
e CLK 
e CMD 
e CTS 
e DSR 
e DTR 
e EN 
All un-named nets, like "Net-(...)" 
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ee Board Setup 

Board Stackup Net Class Clearance Track Width Via Size Via Hole uVia Size uvia Hole DP Width DP Gap 
Board Editor Layers Detault 02 mm 0.25 mm 0.8 mm DA mm 0.3 mm 01 mm 0.2 mm 0.25 mm 
Physical Stackup 

GPIO 01mm 0,1 mm 0,5 mm 0.35 mm 0.25 mm 01 mm 0.1 mm 0.15 mm 

Board Finish 
Solder Mask/Pastu POWER OA mm 0.15 mm 06 mm 0.4 mm 0.25 mm 01 mm 0.2 mm 0.25 mm 

Text & Graphics use 01 mm 0.1 mm 0.5 mm 0.35 mm 0.25 mm 01 mm 0.1mm 0.15 mm 
setas Data 01 mm 0.1 mm 05 mm 0.35 mm 0.25 mm 01 mm 01 mm 05 mm 
Text Varlables 

Design Rules 
Constraints + " 


Pre-cetined Sizes 


Custom Rus hace CA PC 


Violation Severity Net class filter; 8 [coc Data 
Net name filter: CLK Data 
emp Data 
Show All Nets Apply Filters ers Date 
DSR 

Assign Net Clase PTR X Data 
New net class: Data B m& Data 

[EXT_5V POWER 
Assign To All Listed Nets Assign To Selected Nets 100 pio 
flor GPIO 
nma GPI 

Import Settings trom Another Board.. Cancel [ o ] 


Figure 12.3.4.27: Setting up the Data net class. 


Run another DRC to ensure no outstanding violations relating to the Edge.Cuts, courtyard, 
or clearance issue. Below you can see my board's refined outline: 


Figure 12.3.4.28: Board refined outline. 
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And, the board in 3D: 


Figure 12.3.4.29: The refined board in 3D. 


Let's continue with the routing step. 


This board is not trivial, and it contains a large number of footprints and pads arranged in 
a relatively small board. The utilization of four layers will make routing easier; however, it 
will still require significant effort and time. 

It took me more than an hour to complete the routing after practicing in previous itera- 
tions. Before you begin, please ensure that you have enough time to complete this step. 
Follow the general guidelines I listed in the previous project. For the duration of the routing 
process, I used the interactive router set to "Walk around" mode and "Fix all segments on 
click" enabled, and "Optimize entire track being dragged" disabled. 

Generally, I begin routing tracks between nearby pads, starting from the central com- 
ponent. For example, below, you can see my first three tracks in the front copper layer, 
connecting the ESP32 GND pads (1, 38, and 39) and the adjacent EN pads (MOD1 pad 3 
and J2 pad2): 
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Figure 12.3.5.30: Drawn the first three tracks. 


This board contains a differential pair that consist of the SENSOR_VP and SENSOR_VN 
nets: 


Figure 12.3.5.31: Draw track using differential pair routing. 


If you are not familiar with the technique of drawing differential pair routes, please read the 
relevant chapter in the Recipes part of this book. To draw these tracks as differential pairs, 
selected the differential pairs tool from the right toolbar, click on one of the pair pads, like 
4 in MOD1, and draw towards one of the differential pair pads in J2, like 3. 
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Figure 12.3.5.32: Differential pair routing. 


Don't worry if the pair's tracks are not perfect; you can improve them later. 


Continue with the rest of the pads that belong to MOD1, and then continue with the USB 
interface and power components. 


Here are some guideline reminders: 
e Try to arrange tracks close to each other to avoid wasted space. 
e Avoid 90-degree angles. 


e Try to draw tracks in the top layer since the components are surface-mounted. Use 
vias to access other layers if needed. 


e Use the Shift-< hotkey to open the "via" dialog box and select the layer where you 
want to continue drawing. 


In the example below, I opened the layer selection window to create a new layer quickly. 
The hotkey for this window is Shift-<: 


@ Select.. 


F.Cu 


| Int.cu 
In2.Cu 
B.Cu 


Figure 12.3.5.33: Quickly switching between layers. 
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To help you with the routing, I provide the following figures that show the routes in each 
of the four layers: 


“bo T: _ POT 
enoitsiolqx3 | enoits1olqx3 


mos.stolqxt moo,sTolqxt 


Av tidvad SEG23 
-RMBFABieud 


PETTITTE 


Pe, ta fa] 


Tiw aanadizaa =A 


L 


6 D5 D1 D4 
zh) e, feu) ee 
afl Si 


tg 


0000000000000000000 


Figure 12.3.5.34: Completed routing, F.Cu and B.Cu. 
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In2.Cu Int.Cu 


Figure 12.3.5.35: Completed routing, In1.Cu and In2.Cu. 


Below you can see my layout at this point. All the routing is complete, except for several 
GND connections, which 1 will do using copper fills in the next segment of this chapter. 
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As 


SW 


Figure 12.3.5.36: Almost completed routing, pending the copper fills. 


Let's finish the routing step in the next segment, where you will draw the copper fills for the 
GND and VDD33 nets. You will also draw a keep-out area for the ESP32 module antenna. 


12.3.6. Layout 4 - Copper fills and keep out areas 
Let's finish work in step four of the layout. In this segment, you will complete two tasks: 
1. Create a keep-out area to protect the ESP32 module antenna from accidental 
placement of other footprints. 
2. Create a copper fill in the bottom copper layer, and connect it to the GND net. This 
will also complete any pending GND routes. 
3. Create a copper fill in the top copper layer, and connect it to the VDD33 net. This 
will also complete any pending VDD33 routes. 
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As I was working on this lecture, I realized that the keep-out area for the ESP32 module 
antenna is something that I should have done earlier in the workflow. Nevertheless, it is not 
late to do it now. If you are not familiar with keep-out areas (or "keep-out zones"), please 
review the relevant chapter in the Recipes part of this book. Select the keep-out zone tool 
from the right toolbar and click on one of the antenna area corners to begin drawing. 


Figure 12.3.6.37: Drawing a keep-out zone. 


In the Rule Area Properties window that appears, select all layers (to keep out objects from 
all selected areas), and give the zone a name: 


e S Rule Area Properties 
Layers: Basic rules: 

O H Fcu | Keep out tracks 
E int.cu Keep out vias 
E in2.cu Keep out pads 
1O E 8.Cu 


Keep out copper fill 
Keep out footprints 


Area name: 
| Antennal 


Constrain outline to H, V and 45 deg 
Locked 


Outline display: Hatched e 


Figure 12.3.6.38: Keep out objects from all layers. 


Draw the area so that it looks like this: 
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Figure 12.3.6.39: Keep-out zone complete. 


Continue to create a copper-filled area in the bottom layer, and connect it to the GND net. 
Here are my settings for this area: 


e o Copper Zone Properties 


Layar Net 


E Fcu Hide auto-generated net names Sort nets by pad count 
Mi mcu — 
H in2cu iSD1 


ecu /5D2 


/SENSOR_VN 
| /SENSOR_VP 
[Txo 
¡TXDO 
JUSB_DN 
| usa. DP | 
| VBUS 
| DD33 


General Electrical Properties Fill 
Zone name: Clearance: 0.508 mm Fill type: Hatch pattern G 
Zone priority level; o 3 Minimum width: 0.254 mm Orientation: 0 deg 
Hatch width: 1,016 mm 
Ses Pad connections: Thermal reliefs E 
Hatch gap: 1524 mm 
Constrain outline to H, V and 45 degrees Thermal relief pap: 0.508 ee 
Locked Smoothing effort: 0 +) 
Thermal reliet spoke width; 0,508 mm a 
Outline display: Hatched B Smoothing amount; O > 
Remove islands; Always 8 
Corner smoothing: None ic} 
Filet radius: mm 
Export Settings to Other Zones Cancel PARA 


Figure 12.3.6.40: B.Cu copper zone properties. 


Finally, create a copper layer in the top layer, and connect it to the VDD33 net: 
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o e Copper Zone Properties 
Layer Net 
B E Feu ] © Hide auto-generated net names Sort nets by pad count 
© im.cu 
M m2.cu 
E ecu 
Genaral Electrical Propartion Fit 
Zone name: Clearance: 0.508 mm Fill type: Hatch pattern B 
Zone priority level: o 2 Minimum width: 0.254 mm Orientation: o deg 
> Hatch width: 1,016 mm 
shape Pad connections: Thermal reliefs 
Hatch 1,524 mm 
Constrain outline to H, V and 45 degrees s me: 
Thermal relief gap: 0.508 mm IN 
Locked Smoothing effort: 0 E 
Thermal relief spoke width: 0.508 mm z A 
Outline display: Hatched 8 Smoothing amount; © $ 
Remove islands: Always a 
Corner smoothing: None 19] 
Fillet radius: mm 
Export Settings to Other Zones Cancel Pa 


Figure 12.3.6.41: F.Cu copper zone properties. 


When you finish drawing the copper fills, fill them and do a DRC. In my instance, the DRC 
found several unconnected GND and VDD33 pads. Here is an example: 


Rafik all zones before perfoersing ORC d 
Report all errors for each track 


Violations 15) — Unoonnected itemi 


Error: Missing connection between Items 
Track [GND] on B Cu length 2.2188 mm 
Track [GND] on FCu length 13993 mm 

Error: Missing connection between items 
Track [GND] an F.Cu, length 1.3100 mm 
Pad 5 of J1 on Ou 

Error: Missing connection between items 
Track [GND] on B,Cu, ingih 29320 mm 
Track [GNO] on F.Cu, length 0.6637 mm 

Error: Missing connection between items 
Through hole pad 14 of 32 
Track [GND] on F.Cu, length 1.8100 mm 


irs O) Warnings 


Delete Marker Delete All Markers 


Figure 12.3.6.42: An unconnected VDD33 pad. 


The two VDD33 pads, one in the bottom layer and one in the top, are unconnected after 


the copper pours. There are similar instances of other VDD33 and GND pads with the same 
problem. 


You will need to draw tracks and vias to fix such bugs. Use the list of violations in the DRC 
window to guide you and disable the copper fills to better visibility. 
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The violation in figure 12.3.6.42 (above) is easy to fix with a via and two copper track 
segments: 


Figure 12.3.6.43: Fixed an "unconnected pad" violation. 


Continue in the same manner to fix the rest of the violations. Here is my completed layout, 
fully routed and filled: 


Figure 12.3.6.44: The project PCB, fully routed. 
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Step four of the workflow is now complete. Let's continue with the silkscreen. 


12.3.7. Layout 5 - Silkscreen 
In this step of the workflow, you will work on text and graphical elements on the top and 
bottom sides of the board. Here is a list of things to do: 
1. Optimize the size and location of text labels, like "D6" and "R18". 
. Add text labels for the pin headers. 
. Add text labels for the buttons. 
. Add logos on the back of the PCB. 
. Add board information in the back layer, such as the name and version. 
. Fix silkscreen-related violations reported by the DRC. 


Dun bu NN 


Begin by reducing the size of footprint reference text labels. From the Edit menu, choose 
"Edit Text and Graphic Properties." Select "Reference designators" in the Scope, and set 0.1 
mm for the line thickness and 0.7 mm for the text width and height. Click OK, and confirm 
that the new text size for the values is a better match for the size of the board. 

One by one, reposition those text items to be near their corresponding footprint, and they 
don't overlap. To make this work easier, use the Edit Text and Graphic Properties window 
to make all items in the F.Fab layer invisible. 

Below you can see the text in the front silkscreen 


REF** 


Figure 12.3.7.45: The contents for the front silkscreen layer. 
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And here are the contents of the bottom silkscreen layer: 


_ “foal: 
enoitmolqxsa 
nos.srolaxi 


beh 


HTIW U3MDI230 


Figure 12.3.7.46: The contents for the back silkscreen layer. 


I think that the contents of the silkscreen, back, and front, as you see it above, are suffi- 
cient. 

Before doing the final DRC, I want to do another round of improvements with the routing 
and fix a few minor issues that I noticed during the work in the silkscreen. 


12.3.8. Layout 4 - Routing improvements 

This project is close to completion. In this segment, I want to make a few final improve- 
ments in the copper tracks. 

For example, I noticed that the gap between those two track in one of the inner layers is 
too wide: 
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- 


> 
D 126 
4 | 
Large gaps can waste valuable space on a PCB, and this waste can be significant when you 


need to add elements such as a via to complete a connection. 
Here is another example: 


Figure 12.3.8.47: Minimizing gaps. 


Before After 
Figure 12.3.8.48: Opt for straight tracks. 


The track in the left of the figure above had three bends, even though it connected two 
near-by pads. Just use a straight track like in the example on the right. 
A final example, where I have replaced a 90-degree corner with 45-degree ones: 


Le | 
E 
/BUS vBUS 
RDW TXD M RXDB TXD 
m | 


Before After 


Figure 12.3.8.49: Replace 90-degree corners with 45-degree ones. 
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Take your time to look for other improvements, and continue to the last DRC in the next 
step. 


12.3.9. Layout 6 - Design Rules Check 

Time for the final design rules check. 

My check only shows one violation and twenty schematic parity warnings. The violation is 
a warning about a silkscreen overlap. You can see this below: 


Y RETT ofl zomes betore performing O8C Z Ten tar vary Denween PCR an 


4 Repeet a meros los each Irach 
Vaasaa ji Unccmectad tems (9) Schematic Purity (20) 
Warming Stkacresn averte. 


a an F Saeron 
PCS Text "US on Ferca. 


po vw MO vmmañ vunom 


Delete Marker Delete AP Masies Case 


This is easy to fix by moving the text label "15" off the line. 

The schematic parity warnings have to do with pads without a net. These warnings are 
generated for pins marked as "unconnected" in the schematic, and they are safe to ignore. 
With the last warning fixed, the layout is ready to export as Gerber files and upload to the 
manufacturer. 


12.3.10. Layout 7 - Manufacture 

The layout is complete and tested. In this segment, you will export the Gerber files, check 
them for defects, and upload them to the manufacturer's website. 

The process is similar to the previous projects, with one important difference. In this pro- 
ject, the clearances are smaller than those in previous projects. You must be careful to 
select the appropriate clearances in the manufacturer's order form to be at least equal or 
smaller than the clearances in the layout. 

Below I provide my settings for the Gerber file export: 
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... Plot 
Piot format; Gerber Output directory: ESP32 Devkit Clone Gerbers/ = 
Included Layers Genera! Options 
F.Cu Plot border and title block Drill marks: 
Im.Cu Plot footprint values Sealing: 
nia Plot reference designators Plot mode: 
Y Cu r 
FAdhesive Force plotting of invisible values / refs Use drill/place file origin 
B.Adhesive Plot Edge.Cuts on all layers red plot 
F.Paste Sketch pads on fab layers ’ | 
B.Paste Do not tent vias Check zone fills before plotting 
F.Silkscreen 
B.Silkscreen Gerber Options 
o KE Use Protel filename extensions Coordinate format; 4.6, unit mm GB 
oe ge Generate Gerber job file Use extended X2 format (recommended) 
UserComme... Subtract soldermask from silkscreen Include netlist attributes 
User.Eco1 Disable aperture macros (non recommended) 
Output Messages 
PIURA IY I UITI WPT UL IE arras puren OLLE NSENILAL Line a PIU ve rIMEHO Ur Ye wivi 
devkivESP32 Devkit Clone Gerers/ESP32 Cl Clone devki devKit Cu, 
Piotted to /Users/peter/Documents/Kicad/Course development erent ias Like a Pro 3e Projects/ESP32 Clone 
devkiVESP32 Devkit Clone Gerbers/ESP32 Clone devkit-Int_Cu.g2". 
Show: All Errors QD Warnings O Actions Infos Save... 
Run DRC... Close Generate Drill Files... (QD 
4 
Figure 12.3.10.51: Gerber file export settings. 
And the drill files export settings: 
ee Generate Drill Files 
Output folder: ESP32 Devkit Clone Gerbers/ m 
Drill File Format Drill Origin Hole Counts 
Excellon O Absolute Plated pads: 42 
‘ Drill/place file origin Non-plated pads: 0 
Drill Units Through vias; 45 
Micro vias: 0 
Dval Holes Drill Mode Buried vias: o 
Zeros Format 
O Gerber x2 
Map File Format 
HPGL 
or Precision: 46 
DXF 
SVG 
PDF 
Messages 
Created file '/Users/peter/Documents/Kicad/Course development documents/KiCad Like a Pro 3e Projects/ESP32 Clone devkit/ESP32 Devkit Clone 
Gerbers/ESP32 Clone devkit-PTH-drl.gbr', 
Created file '/Users/peter/Documents/Kicad/Course development documents/KiCad Like a Pro 3e Projects/ESP32 Clone devkit/ESP32 Devkit Clone 
Gerbers/ESP32 Clone devkit-NPTH-drl.gbr'. 
Generate Report File... Close p Generate Map File 
a 4 


Figure 12.3.10.52: Gerber file export settings for the drills. 


Generate the measurements for the board so that you can provide them to the manufac- 
turer's order form: 
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Figure 12.3.10.53: Board size and characteristics. 


To add the board characteristics to the editor, choose "Add Board Characteristics" under the 


Place menu, and select one of the User layers. 
Use the Gerber viewer to validate the Gerber files: 


Gerber Viewer 
v Drawing layer 14 not in use 
Grid; 0.6350 mm (0,0250 in} GB Zomato El 
Layers Manager 
Layers 
1 ESP3...pper, L1) 
5 2 ESP3...,NPTH,) 
3 ESP3...,Mixed) 
+ 22 (Y) 4 ESP3...file, NP) 
5 ESP3...sk, Bot) 
6 ESP3...sk, Top) 
q £ Í + 12 Ç) 7 ESP3...nd, Bot) 
IB x B ESP3...nd, Top) 
C . © 9 ESP3...te, Bot) 
u 10 ESP...te, Top) 
11 ESP3...per, L4) 
© MO) 12 ESP...per, L3) 
13 ESP...per, L2) 
» A E) Graphic layer 14 
Graphic layer 15 
© E) Graphic layer 16 
©) Graphic layer 17 
=E G Graphic layer 18 
Graphic layer 19 
Graphic layer 20 
ES [Y Graphic layer 21 
Graphic layer 22 
Graphic layer 23 
Graphic layer 24 
Graphic layer 25 
= [Y Graphic layer 26 
Graphic layer 27 
A E) Graphic layer 28 
Graphic layer 29 


"IRE 


Graphic layer 30 
Graphic layer 31 
YG Graphic layer 32 
Graphic layer 33 
©) Graphic layer 34 
WG Graphic layer 35 
Graphic layer 36 
@ Graphic layer 37 
Graphic layer 38 
Graphic layer 39 
2 (Y Graphic layer 40 
Graphic layer 41 
WG Graphic layer 42 
Graphic layer 43 
©) Graphic layer 44 
© Graphic layer 45 
© Graphic layer 46 
Graphic layer 47 


Figure 12.3.10.54: Gerber Viewer showing all layers. 
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The Gerber Viewer shows no issues of concern; now, I can proceed with the order. My order 
form is below. My order form is below. 


= x 
Ti 
iza (singar: O x | 57.196 Tatil PAR iy D D g A Pricing And Build Time 
PCR Pri Price Comparison Matris 
* Quantity (single 5 pes 
ayu) ‘Lager | | ime Bayo | taven | | 10Ls  t2Layen © ; 
4 1-9 days 5 $222 
14 Layers 
El . 
nipping Cast 
al aus 
Material) < Aluminum B Rogers HDI(Buned/bind was} 
met) @ Mio: 
Qe Copp] Bane 
"Material model can be remane below HOI in available for 4-Lay or more 
FRA-TG®) TG 130-3140 | TG 150-160 
Trekness) 2 5 08 0 2 20 4 B B 3 
t 
Min Track/Spacing ini Sera 
An Holo Szo: O 0. mm  0.2mm bre No Orie O 
Welcome back, may I help you? 
Mask O E coon B Yello 
WPuple Wi Mattebiock Mi Matte green Z None Write a message 
Stkscroon:© Wick nons A 
Edge cannactor:O ves [no] 


Figure 12.3.10.55: Project PCB order form. 


In the order form I show above, I have marked the most important fields with yellow cir- 
cles. This is a four-layer PCB, and I have selected 3/3mil for the track spacing and 0.3 mm 
for the minimum hole size. These values match the 0.1 mm track spacing and 0.3 mm min- 
imum hole diameter that I used for the board's design. With these values, the cost of five 
copies for this PCB is $222. The clearance settings I have chosen (in response to the tiny 
components listed in the reference BOM) have increased the cost significantly. It is possible 
to design the layout for this PCB using larger settings and reduce the cost by a magnitude. 
With this, I declare this project complete! 


12.4. 3D shapes 

In this chapter, I will add several missing 3D models so that the 3D viewer can synthesize 
a complete 3D rendering of the board. 

At the end of the layout workflow, my board looks like this in 3D: 
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Figure 12.4.1: 3D rendering of my board. 


As you can see above, the layout contains 3D models for the voltage regulator in the back 
and the headers, capacitors, LEDs, and resistors in the front. 
Let's go through the footprints that don't have a 3D model. Here are the sources of the 3D 
models I used: 

e ESP32 module, from Snapeda*”: ESP32-WROOM-32D.step 

e CP2102N chip, from Snapeda**: CP2102N-A01-GQFN28.step 

e Buttons, from Snapeda**: b3s-1000p.stp 

e USB connector, from KiCad's library: Connector_USB.3dshapes/USB_Micro-B_ 

Molex_47346-0001.wrl 
e Transistors, from KiCad's library: Package_TO_SOT_SMD.3dshapes/SOT-23.wrl 


Download, install and set up these 3D models in your layout. Below you can see my board 
in 3D, with all 3D models included: 


Figure 12.4.2: 3D rendering of my PCB, front, all models included. 


12 https://www.snapeda.com/parts/ESP32-WROOM-32U/Espressif%20Systems/view- 
part/?ref=search&t=ESP32-WROOM-32U 

13 https://www.snapeda.com/parts/CP2102N-A01-GQFN28/Silicon%20Labs/view- 
part/?ref=search&t=CP2102N-A01-GQFN28 

14 https://www.snapeda.com/parts/B3S-1000P/Omron%20Electronics/view-part/?ref=search&t=b3s- 
1000p 
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Figure 12.4.3: 3D rendering of my PCB, back, all models included. 
Congratulations for completing this project! 


12.5. Finding and correcting a design defect 
As part of the beta program of this book, a reader found a defect in the schematic of this 
project. In this chapter I will show you how to quickly fix this defect. 


The defect 

During my copying of the elements and wiring from the ESP32 devkit reference design to 
my KiCad schematic, I did not notice that transistor Q2 was flipped. In the reference de- 
sign, the emitter of Q2 (pin 2) is connected to DTR, as in the image below (this is a segment 
of the reference design): 


EN 


Q1 
SS8050-G 


Figure 12.5.1: Segment of the reference design showing the correct wiring for Q2. 
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When I copied this network to my KiCad schematic, I did not notice the correct orientation 
of the emitter. The result is that I connected the emitter (pin 2) to 100 instead of DTR. In 
the image below, I show the error in the schematic: 


EN 


DTR 


MMSS8050—H—TP 
N 


RTS 
b MMSS8050—H-TP 
IN 


100 


10K(5%) 


Figure 12.5.2: The arrow shows the error in my instance of the schematic. The emitter 
(pin 2) of Q2 is connected to IOO instead of DTR. 


Fortunately, this defect is easy to fix. 


12.5.1. Fix the schematic 

First, let's fix the defect in the schematic. 1 have to re-orient the emitter of Q2 so that it 
points towards Q1. The easiest way to do this is to use the "Mirror Vertically" option of the 
Q2 symbol properties (see below). 


DTR Q1 


MMSS8050-H-TP 


Rotate Counterclockwise 
Rotate Clockwise 


A ncn ger ri Mirror divinas 


Edit Footprint... 
Figure 12.5.1.3: Fix the wiring defect by flipping Q2 vertically. 
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After the defect is corrected the Q2 and Q1 wiring will look like this: 


EN 


DTR Q1 


MMSS8050-H-TP 


RTS Q2 


MMSS8050—H-TP 


100 


10K(5%) 


Figure 12.5.1.4: The defect is corrected. 
Save the schematic. Let's continue the correction process in the layout editor. 
12.5.2. Fix the layout 


In Pcbnew, import the changes in the schematic into the layout, and notice that there are 
a couple of new ratsnest lines in Q2 (see below). 


Figure 12.5.2.5: After importing the schematic changes, ratsnest lines appear in Q2. 
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After the import of the schematic changes, the layout editor did not delete the copper trac- 
es that connect Q2 pins 2 and 3 to other parts of the PCB. The only clue that something 
has changed are the two new ratsnest lines. You will need to manually delete the original 
copper traces, and draw new ones. 

In the image below I have already deleted several obsolete copper traces that originally 
connected Q2 pins 2 and 3 to the 100 and DTR nets. I also dragged the DTR copper trace 
and via (marked with the yellow arrow) to the left to make it easier to connect to Q2 pin 
2 next. 


Figure 12.5.2.6: Removed obsolete copper traces. 


Finally, re-draw the copper traces. In the figure below, I use arrows to highlight them: 


Figure 12.5.2.7: New copper traces from Q2 pins 2 and 3. 
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With the re-draw complete, the original defect is now corrected. Do a DRC to ensure there 
are no other issues to address. My DRC shows a problem with the copper track coming from 


MOD1 pin 26 (see below). 
| ES 


“i Dios O Owm i te Soe 


w 
d i a T E 


Figure 12.5.2.8: A new violation. 


To fix this violation, 1 opted to delete the via and adjoining traces, and re-draw them. You 
can see the result below: 


Figure 12.5.2.9: Re-wired and fixed the last violation. 


My latest DRC showed no further defects, so I was able to re-export the Gerber files. 
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Part 13: Recipes 


13.1. Create a custom silkscreen or copper graphic 

One of the most common «finishing touches» of PCB design is to add graphics. For exam- 
ple, you could add decorative pictures, a logo, or a stamp representing something impor- 
tant about your new board. 

In the projects in this course, I have routinely added two specific graphical elements: The 
Tech Explorations logo and the KiCad logo. Here's an example (13.1.1): 


pg 


U 
Data logger with KLET: 
the ATMcga328?, DESIGNED WITH 


Tech 
Explorations 


— 2Mbit EEPROM 
SIRIG 


— 12C, SPI, GPlOs 


Figure 13.1.1: Two examples of graphical elements, placed in the back silkscreen. 


In this example, I have placed the two logos in the back silkscreen layer. The KiCad logo 
is available from the footprint library marked as "Symbol" that ships with KiCad (Figure 
13.1.2). 


a o Choose Footprint (12516 items loaded) 


>» Sensor_Pressure 
> Sensor_Voltage 
Socket 
SS12D07VG4 
v Symbol 
CE-Logo_8.5x6mm_SilkScreen 
CE-Logo_11,2x8mm_SilkScreen 
CE-Logo_16.8x12mm_SilkScreen 
CE-Logo_28x20mm_SilkScreen 
CE-Logo_42x30mm_SilkScreen 
CE-Logo_56.1x40mm_SilkScreen 
ESD-Logo_8.9x8mm_SilkScreen 
ESD-Logo_13.2x12mm_SilkScreen 
ESD-Logo_22x20mm_SilkScreen 
ESD-Logo_33x30mm_SilkScreen 
ESD-Logo_44.1x40mm_SilkScreen 


ESD-Logo_6.6x6mm_SilkScreen 
Electrostatic discharge Logo 


Keywords Logo ESD 


Select with Browser Cancel [ ok O] 


Figure 13.1.2: The Symbol footprint library contains several graphics footprints. 


d 
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You can select any of the available footprints in this library and drop them on the PCB editor 
as you would with any other footprint. 

If you want to use a graphic not available in the existing libraries (and you can't find it any- 
where on the Internet), you can create it. 

In this Recipe, I will show you a simple method that yields a high-quality graphical footprint. 


First, let's look at the layers that can hold a graphical footprint. You can place graphic foot- 
prints in four layers: 

e Front silkscreen (F.Silkscreen). 

e Back silkscreen (B.Silkscreen). 

e Front copper (F.CU). 

e Back copper (B.CU). 


Regardless of which one you choose, the process for creating custom graphics in KiCad is 
the same. 


Here is the process, in a nutshell (Table 13.1.1): 


Step # Description 


1 Find the raw image that you want to use and convert it to a black and white 
bitmap. 


Use the KiCad Image Converter app to convert the bitmap image from step one 


2 
into a footprint. 

3 Save the new graphical footprint into a library, and add the library to the scope of 
your project. 

4 Add the new graphical footprint to your PCB in Pcbnew. 


Table 13.1.1: The four steps for creating a custom graphical footprint. 


KiCad's Image Convert app can convert a bitmap into four different formats: 
e Symbol (.lib file) 
e Footprint (.kicad_mod file) 
e Postscript (.ps file) 
e Drawing Sheet (.kicad_wks file) 


Since we are interested in creating a graphic, we'll be exporting it to a .kicad_mod file 
(footprint). 
Let's begin the process. 


Step 1: A graphic in its original format 

For this example, I'll be starting with a color PNG image file. You can also start from a JPEG 
or other image file format (you'll need to adjust the operation of converting your starting 
image file to a black and white bitmap) (Figure 13.1.3). 
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© © techexplorations_Jogo.png © cof A Open with Preview 


Tech | 
Explorations 


www.techexplorations.com 


Figure 13.1.3: I'm starting with this PNG color image. 


My original image contains elements in black, red, and white (the background). I need to 
convert this image into a black and white (only) bitmap image. Therefore, I will need to 
convert any red contents into either black or white. In this case, it makes sense to convert 
the red content into black. 


I'm not a graphics designer and don't want to overthink problems like this. Instead of using 
a graphics tool like Photoshop to do the job (a clear overkill), you can use one of the many 
online image converters. A quick Google search will reveal a selection of online (and mostly 
free) image format converters. I found that the one at https://image.online-convert.com/ 
is precisely enough for this task. This tool offers a variety of converters. The one you want 
is "image to BMP". You can find it at https://image.online-convert.com/convert-to-bmp. 
Drag and drop the PNG file in the green file area to upload the image (Figure 13.1.4). 


e 179 


KiCad Like a Pro, Projects, Tips and Recipes 


h <> . 0 TE; 'image-online-convert.com/convert-to-bmp 6 
Convert To GIF 
Convert To HDR/EXR 
Convert To ICO 
Convert To JPG 
Convert To PNG 
Convert To SVG 
Conwert To TGA 
Convert To TIFF 
Convert To WBMP 
Convert To WebP 


converter Add example file 
= 
> Video converter 


+ Webservice converter Optional settings 


techexplorations_logo.png 78.19 KB £ 


Toot Change Size: 1-65000 x 1-65000 pl 
» Capture Website Color: Colored Gray © Monochrome — Negate 
Year 1980 Year 1900 
> Compress Document 
R Enhance: Deskew Equalize Normalize Enhance 
Compress Image Sharpen  NoAntialias Despeckie Remove background 
> Compress Video DPI: er 
+ OCR - 
Crop pixels from: 100000 top ©- 100000 bottom 
)- 100000 left O-100000 right 
Sean athe Gees 
threshold: @ 2 
Save settings 
Save settings as: @ ener aname (Log in to activate) 


> Start conversion 


Figure 13.1.4: The image converter form. 


Once the file upload is complete, check the "monochrome" option (1) under "Color". You 
can leave all other settings unchanged. 

The "Black and white threshold" (2) accepts a number that helps you control which areas 
of the original image file will be converted to black and white. For simple graphics, like the 
Tech Explorations logo, the tool does a good job of automatically working out the conver- 
sion threshold. I did not have to make any changes here. However, if you are not getting 
the desired results, play around with a few numbers in the threshold text field until you find 
the one that works best. 


Click on the green "Start conversion" button to trigger the conversion, and download the 
new BMP file. 


fp-info-cache 2bytes Document 
fp-lib-table 120 bytes Document 
~ EJ Graphics -- Folder 
B techexplorations_logo.bmp Windo 
~ techexplorations_logo.png 80 KB PNG image 
w OD Libraries -- Folder 
> fm 3D — Folder 


Figure 13.1.5: The image converter form. 
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Now that you have the new BMP file (Figure 13.1.5), you can continue with Step 2. 


Step 2: Use the Image Converter to create the footprint 
To start the KiCad Image Converter app, go to the KiCad Project window, and click on the 
Image Converter icon (Figure 13.1.6). 


eee MCU Datalogger — KiCad 
E Project Files 


f mcu vatalogger.kiesd_peo Schematic Editor 


æ Edit the project schematic 
IM WCU Datalogger-backups 

o MM 2 ayer McU_Datalogger_Gerbers Symbol Editor 
Z BBB 4 Joye MCU_Datalogger_Gerbers Edit global and/or project schematic symbol libraries 
- BB Libraries > 
= PCB Editor 
ney l] MCU Datalogger.kicad_pcb Edit the project PCB design 

+ MCU Datalogger kicad_sch 
an Footprint Editor 

autosave-MCU Datalogger.kicad_pcb 
L penises eee Edit global and/or project PCB footprint Nbravies 


Gerber Viewer 
Proview Gerber files 


Image Converter 
Convert bitmap images to schematic symbols or PCB footprints 


Calculator Tools 


Show toois for calculating resistance, current capacity, etc. 


Drawing Sheet Editor 
Edit drawing sheet borders and title blocks for use in schematics and PCB designs 


pitmap2component closed [pid=44358] 


Figure 13.1.6: The image converter form. 


In Image Converter, click on the "Load Bitmap" button and then find and open the BMP file 
you just created. Your Image Converter will look like this (Figure 13.1.7): 


ee Bitmap to Component Converter 


Shira information 


Original Picture Greyscale Picture — Black&White Picture 


Bitmap size; 940 783 pixots 
Bitmap PPE 300 300 Ppt 
BPP. 32 bits 


Oviout Parameters 


Lock helghtiwidth ratio (ey 


Size 786 667 m E 


Export to Clipboard 


Oviput Format 


Symbol ( lib filo) 
© Footprint LJicad_mod file) 
Postscript (.ps Me) 
Drawing Sheet (kicot_wks tile) 
E | ti = 


www.techexplorations.com Negative 


Board Layer tor Outine 

© Front silk screen 
Front solder mask 
User layer Eco! 
User layer Eco? 


Black / White Threshold: 


o 70 100 


sertipater/DocumuntyKicad/Course development documenteKiCad Like a Pro Se Project MCU Dutaingper/Graphicsnactenivierstions Jogo. bmp 


Figure 13.1.7: The image converter form. 
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You can switch the image view between "Original Picture," "Greyscale Picture," and 
"Black&White Picture." At this point, ensure that the black and white picture is how you 
want it. This is where you can confirm that the PNG to BMP conversion was successful. If 
there is something that you want to improve in the image, should do it now by returning 
to Step 1 of the process. 


If the black and white picture looks good, you can proceed. Ensure that you have selected 
the "Black&White Picture" tab and focus on the Size widget container. This is where you can 
control the size of the footprint that you are about to create. As the number of pixels in the 
original photo is fixed, changes in the size will affect the resolution. 

To work out the appropriate size of the graphic, go back to Pcbnew and use the measure- 
ment tool to find out the height and width of the graphic (Figure 13.1.8). 


z ZASE J o 


s1olqxt 


Figure 13.1.8: The image converter form. 


In my measurement (see above), I confirm that I can place my logo graphic in the ap- 
proximate center of the PCB, with a width of around nine or ten millimeters. With this 
information, go back to the Bitmap to Component Converter app and type "10" in the first 
Size text box. The default state of the height/width ration lock is "locked," so the tool will 
automatically calculate the height for the graphic (Figure 13.1.9). 
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eee Bitmap to Component Converter 


Bitmap ‘formation 


Orginal Picture Greyscale Picture — Blackkwnite Picture 


Bitmap sze- 940 788 pixels 
Bitmap PP: 300 300 PPI 
BPP: 32 bits 


Lock height/width ratio fed 


Size; 10 


Load Bitmap 
Export to Fila 
Export to Clapboard 


Duta Formas 


Symbol (lis fits) 
OO Footprint (Jácad_mud fe) 
Pastacript (ps fila) 
Drawing Sheet (icad wks file) 
E | | = iwant Options 


www.techexplorations.com Negative 


Board Layer tor Dina 

© Front silk screen 
Front solder mask 
User layer Eco 
User layer Eco2 


Black / White Threshold: 


0 70 wo 


[perra Docta Kend Curas devaient cocanmtyK Cad Lite a Pro Se Projecta UCU OntalaaoeiCraphecaltachmeploratans tego mp 


Figure 13.1.9: Set the size of the footprint. 


Notice that as you manipulate the size numbers, the figures in the "Bitmap information" 
group also change. In general, as long as the Bitmap PPI is over 300, your graphic will look 
good in the final manufactured PCB. 

Ensure that you set the output format to "Footprint." 

You can also play with the Black/White Threshold and see how it affects the image. For 
this image, it looks best when the threshold is around 50. In the same widget group, you 
can check the "Negative" checkbox. This way, you can flip black and white regions. As the 
graphic appears in Figure 13.1.9, the graphic background is drawn with white ink in the 
silkscreen. The text and logo are ink-free, so they "inherit" the color of the solder mask. If 
you check the "Negative" box, the logo text is drawn with the white silkscreen ink, and the 
background is clear as it inherits the color of the solder mask. 

Finally, select the layer for the footprint you are about to create. You can choose between 
the silkscreen, solder mask, and user layers Ecol or Eco2. The silkscreen and solder mask 
will produce a graphic that is visible when the PCB is manufactured. However, the user 
layers are not manufactured. If you choose a user layer, you will need to do further work 
in Pcbnew to change one of the manufactured layers if you want this graphic to be visible. 
In my example, I have selected the "Front silkscreen." You will be able to place the footprint 
on the back silkscreen in PcbNew. 

Finally, click on "Export to File" button, and save the new footprint in your project or custom 
libraries directory. You will use this file in the next step (Figure 13.1.10). In this example, 
I am saving the new footprint inside a directory that KiCad and PCBnew are already con- 
figured to look for footprints. This means that I will be able to use the new graphic imme- 
diately. If you are saving the new footprint in a location that Pcbnew does not know about, 
you should follow the process I describe earlier in this book to install the library in Pcbnew 
before you can use it. 


e 183 


KiCad Like a Pro, Projects, Tips and Recipes 


Save 


TE_Logo_10mm_positive] 


Name Date Modified 


New Folder Cancel NEO 


Figure 13.1.10: Set the size of the footprint. 


As part of the filename, I take care to include the size ("10mm") and other information 
that can help me choose between alternatives later on (such as "positive" vs. "negative," 
"silkscreen" vs. "solder mask" etc.). 


Step 4: Use the new graphical footprint in Pcbnew 

If you saved your new footprint in one of the footprint libraries already in the KiCad foot- 
print libraries path, you can continue with Pcbnew. 

Start Pcbnew, select the "Add footprint" tool from the right toolbar and click anywhere in- 
side the editor to bring up the footprint chooser. Search for the new footprint by typing part 
of its name in the filter box (Figure 13.1.9). 
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DesktopLibrary 
TE_Logo_11.8x4 

Footprints 
TE_Logo_10mm_positivo 

Symbol 
CE-Logo_8.5x6mm_SilkScroen 
CE-Loga_11.2x8mm_SilkScreen 
CE-Logo_16.8x12mm_SilkScreon 
CE-Logo_28x20mm_SilkScreen 
CE-Logo_42x30mm_SakSereen 
CE-Logo_56.1x40mm_SilkScreen 
ESD-Logo_6.6x6mm_SilkScreen 
ESD-Logo_8.8x8mm_SilkScreen 
ESD-Logo_13.2x12mm,_SilkSereen 
ESD-Logo_22x20mm_SilkScreen 
ESD-Logo_33x30mm_SilkScreen 
ESD-Logo_44,1x40mm_SilkScreen 
FCC-Logo_7.3x6mm_SitkScreen 
FCC-Logo_9.6x8mm_SilkScreen 
FOC-Loga_14.6x12mm_SilkScreen 


ENE h aae AA NA OMA aa 


TE _Logo_10mm_positive 


Keywords 


Select with Browser 


Choose Footprint (12526 items loaded) 


Figure 13.1.11: The new footprint is available in the footprint chooser. 


In the example above, I have searched for "logo" (1), and the new footprint is listed under 
my "Footprints" library (2). Double-click to drop the footprint in the editor. 
When the new footprint appears in the editor, double-click on it to edit its properties (Figure 


13.1.12). 


Orientation 


000 
90.0 
-90.0 
180.0 
Other 0.000 


Library link: Footprints:SOICT27P600x175-8N 


Auto-placement Rules 


Allow 90 degree rotated placement: 
o o 
Allow 180 degree rotated placement: 


9 o 


10 


e o Footprint Properties 
General Clearance Overrides and Settings 3D Models 

idth Height Thickness Italic Layer 
Reference designator u2 07 01 [O Fsitkscreen 
Value DS1337S+ 08 0.1 O FSiikscreen 
+ ē 
=i Pi Update Footprint from Library. 

© Unlock footprint 
Lock footprint Change Footprint... 


Edit Footprint... 


Edit Library Footprint... 


Fabrication Attributes 
Component; Through hole 


Not in schematic 
Exclude from position files 
Exclude from BOM 


Cancel 


Figure 13.1.12: The new footprint properties. 
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Since I want to place the footprint in the back of the PCB, I have set the "Side" dropdown 
to "Back." I have also unchecked the "Show" checkbox for the reference designator. 
In the 3D viewer, the new footprint graphic looks like this (Figure 13.1.13): 


o 3D Viewer 


BECA KK SHE HF Bent s & 


o DESIGNED WITH 


LDHTech: 
Explorations 


txplore.com 


lech 
Explorations 


4 AAA A A 2. _ 
Figure 13.1.13: The new footprint in the back of the PCB. 


If you want to experiment with the negative version of the same footprint, go back to the 
Bitmap to Component Converter app, and check the "Negative" checkbox like this. Export 
the footprint with a new filename so that the original footprint is preserved. I used "TE_ 
Logo_10mm_negative_silkscreen.kicad_mod". Then, add the new footprint to the editor, 
and view it in the 3D viewer. Mine looks like this (Figure 13.1.14): 


Tech | 
Explorations 


www techexplorations com 


Figure 13.1.14: The new footprint (negative) in the back of the PCB. 


You can create as many variations as you wish for the same graphical footprint. There can 
be variations in size, layer, and black/white threshold ("negative" vs. "positive"). 
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13.2. Change a symbols and footprints in bulk 
It is possible to change symbols and footprints in bulk using the respective tools in the 
schematic in layout editors. In this chapter you will learn how to use those tools. 


13.2.1. Change a symbol in bulk 

This section will teach you how to replace the symbol used for a specific component in a 
KiCad schematic in bulk. 

Here's an example. 

Say that you have a schematic that contains several resistors and capacitors, like this (Fig- 
ure 13.2.1.1): 


100R 200R 300 ‘Onn SUOR 


Ou Ou 


Figure 13.2.1.1: This schematic contains several resistors and capacitor; 
we'll change these symbols in bulk. 


$ i: 


es Len 
su 400] 


The symbols I have used for the resistors follow the US/IEEE* 315-1975 style. I would like 
to change all resistor symbols to use the IEC 60617** (International Electrotechnical Com- 
mission) style. You can see a comparative presentation of symbols in Wikipedia”. 

Of course, I could make the change by editing the properties of each symbol, one at a time. 
To do this, double-click on a resistor symbol to reveal its properties window, and then click 
on the "Change Symbol" button (Figure 13.2.1.2). 


15 https://ieeexplore.ieee.org/document/985670 
16 https://std.iec.ch/iec60617 
17 https://en.wikipedia.org/wiki/Electronic_symbol 
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e... Symbol Properties 
General Alternate Pin Assignments 
Fields 
Name Value Show H Align V Align italice Bold Text Size 
Reference R1 Left Center 1.27 
Value 100R Left Center 1.27 
Footprint Center Center 1.27 
Datasheet — Center Center 127 
Purpose Center Center 1.27 
e Be LJ 
anais: Tor Update Symbol from Library... 
Show pin numbers 
ari aaa a Syntol.. | 
ma Edit Symbol... 
Angle: 0 
Mirror; Not mirrored [$] Exclude from bill of materials 
Edit Library Symbol... 
Library fink: Device:R_US Spice Model... Cancel 


Figure 13.2.1.2: The individual symbol properties window. 


This will bring up the "Change Symbols" window, which looks like this (Figure 13.2.1.3): 


ee Change Symbols 
O Change selected ml 
Change symbols matching designator: R1 
Change symbols matching value; 100R 
Change symbols matching library identifier: 
Device:R_US I 
New library identifier: 
Device;R m 
Å- 
Update Fields Update Options 2 
Reference Remove fields if not in new symbol 
Value Reset fields it empty in new symbol 
Footprint 
alahas Update field text 
© Update field visibilities 
Update field sizes and styles 
Update tieid positions 
Select All Select None Update symbol attributes 
Output Messages 


Change symbol A1 from 'Device:R_US' to Device:’: OK 


Show: All © Eros ED O warnings EY Y Actions 


Jam > 
Figure 13.2.1.3: The Change Symbols window. 


Infos Save.. 


In the Change Symbols window, notice that the first option is selected, "Change selected 
symbol(s)" (1). You can choose multiple symbols by holding down the Shift key as you click 
on each symbol. 
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Find the new symbol you want to use by clicking on the library button (2). You can see the 
name of the new symbol in the "New library identifier" text field. 

Click on "Change" to finish the process. 

You can access the Change Symbols window directly. Click on the Edit menu item, and then 
Change Symbols (Figure 13.2.1.4). 


Tools Preferences Helpi 


Ba RQ 
> cut 


B Copy 
D Paste 


Paste Special... 
[i] Delete 


Select All 


D Fina 


Ag Find and Replace 


od Interactive Delete Tool ? 1 


Is HE 


E 


3 


FF» | 


5 EET SET $ 0 ( 


Start Dictation... 
Emoji & Symbols 


| 


Figure 13.2.1.4: The Change Symbols window. 


This makes it possible to change the symbol of more than one component. Using the 
Change Symbols window, you can choose one of these methods: 

1. You can multiple-select all symbols by holding the Shift key down as you click on 
each symbol. Then, bring up the Change Symbols window and follow the same 
process I described earlier (i.e., as if you were changing the symbol for a single 
component). Ensure that the first option, "Change selected symbol(s)," is selected. 

2. You can go directly into the Change Symbols window, without first selecting any 
symbols in the editor, and use one of the other three selection options: 

- Matching reference designator. 
- Matching value. 
- Matching library identifier. 


Let's look at an example where I'll use the library identifier option. 

To begin with, you will need to know the current symbol library identifier. You can find that 
by double-clicking on one of the symbols you want to change. This will bring up the Symbol 
Properties window. You can see the library identifier in the bottom field of the Properties 
window (Figure 13.2.1.5). 
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eee Symbol Properties 
General Alternate Pin Assignments 
Fields 
Name | Valve Show H Align V Align Italic Bold Text Size 
Reference R2 Left Center 127 
Value 200R Left Center 1.27 
Footprint Center Center 1.27 
Datasheet ~ Center Center 1.27 
Purpose Center Center 1.27 
+t By ē 
Ganars! ia Update Symbol from Library... 
Show pin numbers 
Change Symbol... 
© Show pin names acs 
Edit Symbol... 
o Attributes 
Angle: 8 
Mirror: Not mirrored Exclude from bill of materials n 
Edit Lil bol... 
Exclude from board aket bli 
Spice Model... Cancel 


Figure 13.2.1.5: Get the library identifier from the symbol Properties window. 


Copy the library identifier, and then bring up the Change Symbols window (Edit —> Change 
Symbols) (Figure 13.2.1.6). Paste the property identifier in the "Change symbols bathing 
library identifier" field (1). Of course, ensure that this radio button is selected. You can also 
click the library button next to this text field to bring up the library browser and find the 
library identifier instead of copying from another symbol. 

Next, fill in the library identifier for the symbol that you want to use (2). If you know what 
it is, you can either type it in or use the library browser to find it. 


e 190 


Part 13: Recipes 


ee Chagae Symbols 


Change symbols matching reference designator: 
Change symbots matching value: 
© Change symbols matching library identifier: 
Device:R_US 
> 


New library identifier: 


Update Fields Update Options 
Reference Remove fields if not in now symbol 
Value Reset fields if empty in new symbol 
Footprint 
Detashost © Update field text 
Update tleld visibilities 
Update field sizes and styles 
Update field positions 
Select All Select None Update symbol attributes 
Output Messages. 
Show: Ali Errors Warnings Actions infos Save... 
> 


Figure 13.2.1.6: The Change Symbols window setup to change R_US symbols to R. 


There are a few more options that you can explore in the "Update Fields" and "Update Op- 
tions" groups. In most cases, the defaults are appropriate. When you are ready, click on 
"Change" to finish the process. 

With a single operation, all resistor symbols are now changed (Figure 13.2.1.7): 


R1 R2 R3 R4 R5 
100R 200R 300R 400R 500R 


Figure 13.2.1.7: The symbols for the resistors have been changed in bulk. 


The Change Symbols window is a powerful time-saver feature in KiCad 6, similar to its 
"sibling" features "13.5. Edit Text & Graphics Properties," "Find and Replace" and the "In- 
teractive Delete Tool". You can learn more about these features in their dedicated chapters. 


13.2.2. Change a footprint in bulk 

This section will teach you how to replace the footprint used for a specific component in a 
KiCad schematic in bulk. I will use an example of the PCB from one of the projects in this 
book: 
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Figure 13.2.2.8: I will replace the TH resistors with SMD equivalents. 


In the figure above, the PCB contains three TH resistor footprints. I will use the Change 
Footprints tool to replace these footprints with an SMD equivalent. To make a bulk change, 
you must know a property that is common among all footprints. In this example, all re- 
sistors use the same footprint, with the same identifier. You can see this identifier in the 
footprint's properties window (at the bottom of the window): 
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@ a Footprint Properties 
General Clearance Overrides and Settings 3D Models 
Text Items Show Width Height Thickness Italic Layer 
Value 330 1 1 0.15 silkscreen 
S(REFERENCE) 0.72 072 0.108 O FFab 
+ ' 
sce) and Update Footprint from Library... 
x: beta vis g a Change Footprint 
Y: 126.73 mm Só 
Side: Front Edit Footprint... 
Auto-placement Rules Edit Library Footprint... 
Orientation 
Allow 90 degree rotated placement: Fabrication Attributes 
0.0 
90.0 0 0 10 Component: Through hole 8 
-90.0 Nai i Not in schematic 
degree rotated placement: 
© 180.0 e Exclude from position files 
Other; 180.000 o o 10 Exclude from BOM 
cance 


Figure 13.2.2.8: The footprint identifier in the footprint properties window. 


With this information at hand, bring up the Change Footprints tool (under the Edit menu). 
As per the example below, use the fourth options as the footprint selector ("1"), and copy 
the footprint identifier that is common among the footprints you want this change to ap- 
ply to. Then, select the new footprint identifier, "2". You can use the footprint chooser by 


clicking the library button. Finally, click Change. You will see confirmation of the changed 
footprints in the output messages box. 
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r 
o... 


Change selected footprint(s) 


© Change footprints with library id: 


Change Footprints 


Change footprints matching reference designator: 


Change footprints matching value: 


R1 


330 


Show: 


Update Options 


Output Messages 


All Errors (Y warnings (Y) Actions 


Remove text items which are not in library footprint 
Update text layers and visibilities 
Update text sizes, styles and positions 
© Update fabrication attributes 
Update 3D models 


|Resistor_THT:R_Axial_DINO204_L3,6mm_D1.6mm_P7.62mm_Horizontal EN 


New footprint library id: 
Resistor_SMD:R_0201_0603Metric 


Change footprint R2 from 'Resistor_THT:R_Axial_DINO204_13.6mm_D1.6mm_P7.62mm_Horizontal'to 
'Resistor_SMD:R_0201_0603Metric': OK 


Change footprint A1 from 'Resistor_THT:R_Axial_DINO204_L3.6mm_D1.6mm_P7.62mm_Horizontal' to 
"Resistor. SMD:R_0201_0603Metric': OK 


Change footprint A3 from 'Resistor_THT;R_Axial_DIN0204_L3.6mm_D1.6mm_P7.62mm_Horizontal' to 


'Resistor_SMD:R_0201_0603Metric'; OK ES 


Infos 


Close 


Em 


IN 


Sav; 


Click Close to dismiss the window, and look at the results in the editor: 


Figure 13.2.2.9: Changing footprints. 


Figure 13.2.2.10: Changed fo 


otprints. 


The original TH footprints are now SMD. You will need to adjust the copper tracks and finish 


the electrical connections. Notice that the ratsnest lines have appeared and can help you 
with the drawing of the tracks. 


With the help of the Change Footprints tool you will be able to easily change footprints. 
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13.3. Interactive delete 

Deleting unwanted elements of a schematic or layout always contains an amount of risk. 
Yes, you can undo an incorrect deletion or restore from a backup if things have gone wrong. 
But why make a mistake in the first place? In health and medicine, prevention is better than 
any cure, and the same applies to computer-aided design. 

In KiCad, you can delete an element, such as a text item, a symbol, footprint, or graphic, by 
hovering the mouse pointer over the component and pressing the Delete key. You can also 
right-click on an element to bring up the contextual menu and then select Delete. 

The problem with these methods is that it is not always obvious what you are deleting when 
you are working in busy schematics or layouts. 


[TĪ] Autopiace Fields 

J> DeMorgan Conversion 
Pa) Edit with Symbol Editor 
> Change Symbol... 


{O Update Symbol... 


Show Datasheet 


>$ Cut 
[P) copy 
[f° Paste 


Paste Special... 
T Delete 


Figure 13.3.1: Deleting something in Pcbnew (left) and Eeschema (right) entails a level of 
risk. 


In Figure 13.3.1 (above), I am using the context menu to delete an unwanted element. 
In Pcbnew (left), I wanted to delete a track. However, the header footprint was selected 
instead of the track because of imprecise targeting and the active selection filter settings. 
You can see that Pcbnew highlighted the header footprint with white instead of regular 
yellow. In Eeschema, the item with its context menu activated is marked with a fuzzy halo 
around it. It is easy to make mistakes and delete the wrong thing in both cases, especially 
in busy editors. 

If you use the hover and Delete keypress option, you don't even get an indication of pre- 
cisely what you are about to delete. 

To make it safer to delete schematic or layout elements, KiCad provides the Interactive 
Delete tool. This tool is available in both Eeschema and Pcbnew. You can find it in the Edit 
menu and at the bottom end of the right toolbar (Figure 13.3.2). 
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Des 


netclass w 


Qe C Redo 


>$ cut 
[E) copy 
[| Paste 


Paste Special. 
[i] Delete 
Select All 


JP Fina 


Np Find and Replace 


I x Interactive Delete Too! N 18 


ranhice Drnnartiea 


Figure 13.3.2: You can find the Interactive Delete tool in the Edit menu and at 
the bottom end of the right toolbar. Pcbnew (1) and (3), Eeschema (2) and (4). 


When you select the Interactive Delete tool, the cursor changes to a rubber eraser with 
a small cross. Anything that the cross hovers over is highlighted with a configurable color 
(you can customize all colors via the Preferences window; then Schematic Editor —> Colors 
and PCB Editor —> Colors). You can see an example below (Figure 13.3.3). 


<a a1 


MMSS8050-H- 


Figure 13.3.3: An example of the Interactive Delete tool. Pcbnew (left), Eeschema (right). 
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In the layout editor, the Interactive Delete tool will work regardless of the settings of the 
Selection Filter, but it will not allow you to delete locked items. 


13.4. Find and Replace (Eeschema) 

In Recipe "13.2.1. Change a symbol in bulk", you learned how to quickly change symbols 
assigned to a component based on common criteria, like the library designator or the value. 
KiCad offers more bulk-editing tools and dedicates one of them to text in the Schematic 
Editor. 

You can access this tool from the Edit menu. Click on Edit, then click on Find and Replace. 
Let's look at an example where the Find and Replace tool is useful. 

I have a schematic that contains several instances of the "RESET" net label. This label 
exists over two different pages of the schematic. See the images below (Figure 13.4.1). 


Figure 13.4.1: The net label "RESET." I'll change it to "RST." 


I would like to change "RESET" to "RST" using the Find and Replace tool. 
Bring up the Find and Replace tool by clicking on Edit —> Find and Replace. In the "Search 
for" field, type "RESET," and in the "Replace with" field, type "RST" (Figure 13.4.2). 


@ o Find and Replace 


| Searchfor: RESET Find 


0 Match case Words | Rgglace All | 
| Search pin names and numbers Close 

| Search hidden fields 

| Search the current sheet only 

| Replace matches in reference designators 


| 
\ 


Figure 13.4.2: The Find and Replace window ready to get to work. 
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Click on "Replace All." The Find and Replace window will not go away so that you can search 
and replace more text if you want. You can still pan and zoom in on the schematic to con- 
firm the changes. Click the Close button to dismiss the Find and Replace window. 

In the schematic, you can now see "RST" in all net labels that previously contained "RESET" 
(Figure 13.4.3). 


Connectors 


JGND_|. 
A 


Figure 13.4.3: The net label "RESET" has been changed to "RST." 


You can use this tool to find and change any text type, whether a net label or a text item, 
as long as it appears within the schematic. Text that appears in the schematic page settings 
area (in the bottom right corner of the page) is not affected. 


13.5. Edit Text 8: Graphics Properties 

If you want to make bulk changes to text or graphic element properties in the schematic or 
layout editors, you can use the Edit Text & Graphics Properties tool. 

You can access this tool via the Edit menu. Click on Edit, then click on Edit Text & Graphics 
Properties (Figure 13.5.1). 
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A 

D E C redo 

use notclass w ess 
rer >$ Cut 
B Copy 
im Paste 


Paste Special... 
Ti Delete 
Select All 

A Find 


As Find and Replace 


Lx) Interactive Delete Tool 


Edit Text & Graphics Properties. 
A Change Symbols... 
Edit Sheet Page Number... 


Start Dictation... 
Emoji 4 Symbols 


Figure 13.5.1: How to access the Edit Text & Graphics Properties 
tool in Pcbnew (left) and Eeschema (right). 


The tool looks different in Pconew compared to Eeschema, but it works in the same way in 
both variations. 

First, set the scope. The scope controls the type of elements that the tool will target. For 
example, in Eeschema, you can target global labels, wire labels, and values. In Pcbnew, you 
can target values and reference designators. 

Second, set the filters. With the filters, you can define a sub-group within the already set 
scope. For example, suppose you are working on the layout. You have selected the refer- 
ence designator scope. Then, in the filter, you can narrow the targets to only include refer- 
ence designators in the top copper layer. 

Third, define the change that you want to insert. Here is an example: Suppose you work in 
the schematic editor and select the "values" scope. In the "Set to" group (in Pcbnew, the 
same group is named "action"), you can change the size, orientation, and other aspects of 
the text used to show component values to 10mm, Right and Bold. 

Below you can see what the Edit Text & Graphics Properties looks like for Pcbnew (left) and 
Eeschema (right) (Figure 13.5.2). 


e 199 


KiCad Like a Pro, Projects, Tips and Recipes 


Figure 13.5.2: The Edit Text & Graphics Properties window in 
Pcbnew (left) and Eeschema (right). 


Let's look at an example. Say that in the schematic below, you wish to change the color 
and thickness of the wires. At the start, wires have the default thickness and color, and the 
schematic looks like this (Figure 13.5.3): 


u2 
DS13375+ 


GND 


GND 


Figure 13.5.3: Wires drawn with their default color and thickness. 


Bring up the Edit Text & Graphics Properties window, and set the following: 
1. Scope: Wires & wire labels. 
2. Filters: leave defaults. 
3. Set to: 
- Line width: 2mm 
- Line style: Dotted 
- Line color: red 


The window looks like this (Figure 13.5.4): 
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ee Edit Text and Graphic Properties 
Scope Filters 

Reference designators Filter fields by name: 

Values 

Other symbol fields Filter items by parent reference designator: 

Filter items rent symbol library id: 
Wires & wire labels ii dá T symbols B 

Buses & bus labels Filter items by parent symbol type: power 

Global labels Filter i by net: 

Hierarchical labels 

Only include selected items 

Sheet titles 

Other sheet fields 

Sheet pins 

Sheet borders & backgrounds 

Schematic text & graphics 

Set To 

Text size: -- leave unchanged -- mm G Bold h 
Orientation: — leave unchanged- E G italic 
H Alignment (fields only): —leave unchanged- E & Visible (fields only) 
Y Alignment (fields only): ~- leave unchanged-- Ej 
tne wit Em rater = 
Line style: Dotted 15) Sheet background color: 


Figure 13.5.4: I'm changing the "look" of the wires in my schematic. 


Then, click OK. 
The schematic now features huge dotted red lines that represent the wires (Figure 13.5.5): 


de 
......, 
e ch 
abe u2 AS RS o 0.1 uf 
xljix0 e@ © eeeoee||-eco 
eo 2 o 
20 e e R DL 
g@eeee @eeeoe 33 LED e 
ya EN RREK] eee eKeee 
Tol 760 KHz 
@eeeee as cs GNO ci 
eo 0.1 oF 22 pF ett: pe 
@ o o-j|pie o coo ogi" 
FELLD eg 
2 & n ... 
GND o 22 pF 1644.00 O 
000 oo... eS 
Y 
GND 


Figure 13.5.5: The default look of all wires is changed to this red dotted style. 


Of course, the way that wires now look is not particularly helpful. You can undo this change 
by typing Cmd-Z (Mac OS) or Ctr-Z (Windows, Linux). A more helpful change of wire char- 
acteristics would be using the filter and allocating different colors to important nets using 
the Filters. One of the filters allows you to do exactly that ("Filter items by net"). 


e 201 


KiCad Like a Pro, Projects, Tips and Recipes 


13.6. Edit Track & Via Properties (Pcbnew) 

In Pcbnew, you can edit track and via properties, in bulk, similar to how you can edit 
text and graphics properties in both Pcbnew and Eeschema (see recipe "13.5. Edit Text & 
Graphics Properties"). 

You can open the Edit Track & Via Properties window via the Edit menu item in Pcbnew 
(Figure 13.6.1). 


KiCad File View 2 Route Inspect Tools FI 


Edit Track € Via Properties 


Figure 13.6.1: Bring up the Edit Track € Via Properties window. 


It looks like this (Figure 13.6.2): 


e $ Set Track and Via Properties 
Scope Filter Items 
Tracks Filter items by net: le 
yes R Filter items by net class: Default 
Filter items by layer: a me Gs 
Only include selected items 
Action 
O Set to specified values: 
-- leave unchanged — ©  --leave unchanged -- -- leave unchanged -- Y 
Set to net class values: 
Track Width Vía Size Via Drill uVia Size uVia Drill 
Default 0.25 mm 0.8 mm 0.4 mm 0.3 mm 0.1mm 
Power 0.4 mm 0.9 mm 0.5 mm 0.3 mm 0.1 mm 
Cancel OK 


Figure 13.6.2: The Edit Track & Via Properties window. 


If you have used the Edit Text & Graphics Properties tool, you will find Set Track and Via 
Properties familiar. There are three groups of widgets: Scope, Filter Items, and Action. 
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In Scope, you set the kind of item(s) you want to change. In Filter Items, you can narrow 
down the items that you want to change based on their net, class, or layer memberships. 
You can also use your mouse to click and select items manually. Finally, in Action, you can 
specify the changes to be implemented. 

Let's work through a simple example. 

Say you have a layout where tracks that belong to the GND net have a default width of 
0.25mm. Below, you can see a segment of the layout (Figure 13.6.3): 


" vA | 
Figure 13.6.3: The default width of GND tracks is 0.25mm. 


I want to change all GND tracks so that they are 0.50 mm. I know this is excessive, but I'd 
like the change to be visually apparent for the sake of this example. 

To make this happen, we'll use the «Set Track and Via Properties» tool. 

Before that, however, I need to set up the custom track sizes that you'd like to use in the 
Board Setup window. I show this in a dedicated chapter (see "How to create custom sizes 
for tracks and vias"). For this example, I have set two pre-defined track widths: 0.25mm 
and 0.50 mm (Figure 13.6.4): 


000 
A Den DEAQAE 
y Track: use netclass width IE) Via: use netclass sizes E 


Track: 0.250 mm (0.00984 in) 
Track: 0.500 mm (0.01969 im. 
cas, | 7 
+ 


Edit Pre-defined Sizes... 


Figure 13.6.4: I have set a couple of pre-defined track widths; 
I will need them in the Set Track and Via Properties window. 
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Continue by bringing up the Set Track and Via Properties window. Set the options like this: 
e Scope: Tracks. 
e Filter items: Filter items by net: GND. 
e Action: Set to specified values: Track: 0.500 mm (0.01969 in). 
e Everything else should be unchecked or "leave unchanged." 


Here's what the window should look like (Figure 13.6.5): 


r 7 
ee Set Track and Via Properties 
Scope Filter Items 
Tracks Filter Items by net: GND ~ 
Vias 
Filter items by net class: Default 6 
Filter items by layer: E Fcu ~ 
Only include selected items 
Action 
O Set to specified values: 
Track: 0.500 mm (0.01969 in) 8 -- leave unchanged -- 8 ~~ leave unchanged -- v 
Set to net class values: 
Track Width Via Size Via Drill uVia Size Via Drill 
Default 0.15 mm 0.6 mm 0.35 mm 0.25 mm 0.1 mm 
Data 01 mm 0.5 mm 0.35 mm 0.25 mm 01 mm 
GPIO 0.1mm 0.5 mm 0.35 mm 0.25 mm 0.1 mm 
POWER 0.25 mm 0.6 mm 0,4 mm 0,25 mm 0.1 mm 
USB 01 mm 0.5 mm 0.35 mm 0.25 mm 0.1 mm 
Cancel MITIN 
È 2 
Figure 13.6.5: I'm changing the width of all tracks that belong to the GND net to 0.50 
mm. 


KiCad will take a moment to apply the change and will redraw all tracks that belong to the 
GND net to be double their original width (Figure 13.6.6): 


All tracks that belong to the GND net now have a width of 0.50 mm. 


e 204 


Part 13: Recipes 


You can use the same tool to change properties of vias and update via and tracks with the 
values of a revised or added net class. 


13.7. Text variables 

A new feature in KiCad 6 is Text Variables. With Text Variables, you can create variables 
that contain any text string, which you can use in a schematic or layout to parametrize 
anything "text." 

For example, you can set a Text Variable to hold a version number. In your Eeschema and 
Pcbnew designs, you can reference this variable so that it always shows its current val- 
ue. As you are working through new versions of your PCB, you will be able to update the 
version number at a single location (the text variables window) instead of looking for the 
various locations in the schematic and layout editors when the version number may appear. 
Let's look at an example. 

Start by creating a Text Variable. There are two places where you can do this. One is via the 
Schematic Setup dialog box in Eeschema, and the other is in the Board Setup in Pcbnew. 
They are under differently-named groups, but they are the same thing. When you create a 
Text Variable in Eeschema, it will also appear in Pcbnew and vice-versa. 

In Eeschema, click on File, then click on Schematic Setup. Under Project, click on Text 
Variables (Figure 13.7.1). At the bottom of the Text Variables list, click on the "+" button 
to create a new row (1). For the variable name, enter "project_name" (2), and for the text 
substitution, enter "Breadboard power supply" (3). When ready, click on OK to finish (4). 


o o Schematic Setup 
General Variable Name Text Substitution 
Formatting SSAA ONE RUG: 


Field Name Templates 
Electrical Rules 

Violation Severity 

Pin Conflicts Map 
Project 

Net Classes 


at El 


Import Settings trom Another Project... Cancel 


Figure 13.7.1: A new Text Variable. 
Try the same in Pcbnew. Click on File, then Board Setup. Under «Text & Graphics,» you'll 


see «Text Variables.» Click on that to show the variables list. Notice that the variable you 
created in Eeschema also appears here (Figure 13.7.2). 
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le o Board Setup 


Board Stackup Variable Namo ‘Text Substitution 
Board Editor Layers 
Physical Steckup 
Board Finish 
Solder Mask/Paste 
Text & Graphics 
Defaults 


Design Rides 
Constraints 
Fro-detined Sizes 
Net Classes 
‘Custom Rules 
Violation Severity 


+ Ff 


import Settings from Another Board... Cancel 


Figure 13.7.2: The new text variable that was created 
in Eeschema also appears in Pcbnew. 


Next, create a few references to the new variable using its name. For example, let's use 
this variable in the Eeschema Page Settings, which appear in the editor sheet's bottom right 
corner. Bring up the Page Setting window (File —> Page Settings), and enter the variable 
reference "${project_name}" (without the double quotes) in the Title field (Figure 13.7.3): 


o... Page Settings 
Paper Title Block 
Size: Number of sheets: 1 Sheet number: 1 
A4 210x297mm (6) 
Orientation: Issue Date: 2021-07-12 <<< 26/07/2021 > Export to other sheets 
Landscape i Export to other sheets 
Custom paper size: Export to other sheets 
y Export to other sheets 
Comment!: Export to other sheets 
Export to other sheets Comment2: Export to other sheets 
Comments: Export to other sheets 
Previn Comment4: Export to other sheets 
Comments: Export to other sheets 
Comment6: Export to other sheets 
Comment?: Export to other sheets 
Comments: Export to other sheets 
Comments: Export to other sheets 
2. Drawing sheet file 
Browse... 
Cancer QUIEN 


Figure 13.7.3: The variable reference used in the Page Settings. 
Click OK to exit the Page Settings window. Pan the editor to the bottom right corner so 


you can see the Sheet title. It should contain the value of the "project_name" text variable 
(Figure 13.7.4): 
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Tech Explorations 
Sheet: / 
File: Breadboard Power Supply.kicad_sch 


Title: Breadboard power supply 
Size: A4 Date: 2021-07-12 


KiCad E.D.A. kicad (5.99.0-11435-g252647e93c) 


Figure 13.7.4: The variable reference is substituted for its value. 


As you can see, the variable reference was substituted by its value. 


Let's use the same text variable in Pcbnew. Go to Pcbnew, and click on File —> Page Set- 
tings. In the Title field, type the text variable reference "${project_name}" (without the 


double quotes) (Figure 13.7.5). 


r 


o B Page Settings 


Paper Title Block 


Size: 


A4 210x297mm Issue Date: <<< 


© 


Orientation: 
Landscape 


Custom paper size: 
Comment1: 
Comment2: 


r Comment3: 
Preview 


Comment4: 
Comment5: 
Comment6: 
Comment?: 
Comments: 


Comment9: 


Drawing sheet file 


Cancel 


26/07/ 2021 y 


${project_name} 7 


A 


Browse... 


== 


Figure 13.7.5: The variable reference used in the Page Settings in Pcbnew. 


Click OK to exit the Page Settings window. Pan the editor to the bottom right corner so 
you can see the layout Sheet title. It should contain the value of the "project_name" text 


variable (Figure 13.7.6): 


e 207 


KiCad Like a Pro, Projects, Tips and Recipes 


Figure 13.7.6: The variable reference is substituted for its value. 


Let's try something else. Let's create a new text variable and use it in a text item in Ee- 
schema. 

First, open the Schematic Setup window and create a new variable named "input_circuit_ 
name". For the value, enter "Input power and 5Volt subcircuit" (Figure 13.7.7). 


o e. Schematic Setup 


General Variable Name Text Substitution 
connate project_name Breadboard power supp! 
Flota Fergie np creut name fr and Sa poe > 


Electrical Rules 
Violation Severity 
Pin Conflicts Map 

Project 
Net Classes 


+ u 
Import Settings from Another Project... Cancel roo 
Figure 13.7.7: A new text variable. 


Click OK and return to the editor. 

Create a new text item. In the Text properties window, enter a text string containing both 
the variable reference and a fixed string. Notice that as you type the «{«to start typing in 
the text variable name, KiCad will give you a list of valid variable names. You can continue 
typing or choose one of the offered names (Figure 13.7.8). 
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o... Text Properties 


Text: Input and 5Y circuit 
st 


# 
ee 
COMMENTA 
COMMENTZ 
COMMENT3 
COMMENTA 
1. COMMENTS 
COMMENTS 
Justification COMMENT7 Style 


COMMENTS 
Align rigl pps © Normal 


Align b Italic 
Oo Align | F input circuit_name 1 Bold 


Align top project_name Bold and italic 
REVISION 
SHEETFILE 
SHEETNAME 
TITLE 


Text Size: 


Cancel 


Figure 13.7.8: Code completion works with text variables. 


You can see the contents of the Text field below (Figure 13.7.9): 


1) @ Text Properties 


Text: Input and SV circuit 
${input_circuit_name} 


I 
Text Size: 1.27 mm Syntax help 
Justification Style 
Align right © Normal 
Align bottom Italic 
O Align left Bold 
Align top Bold and italic 


Figure 13.7.9: Example that combines fixed text with a text variable. 


Click OK, and see the result of the text variable substitution in the schematic editor (Figure 


13.7.10): 


Input and 5V circuit 


Input power and 5Voltssubcircuit 


Si 
J1 EG1218 
Barrel Jack_Switch 
AAA PWR innut YT 


Figure 13.7.10: A text item with a text variable. 
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Let's see what happens if you make a change to the value of an existing text variable. 
Change the value of the "input_circuit_name" to something else, like this (Figure 13.7.11): 


Variable Name 


input_circuit_name Input power and 5Volt subcircuit .... 
project_name Breadboard power supply 


Figure 13.7.11: I have added a few dots in the text variable. 


Click OK. The text item updates its content accordingly (Figure 13.7.12): 


Input and 5V circuit 
Input power and 5Volt subcircuit ..... 


Figure 13.7.12: The changed text variable value in the text ¡tem. 
You can expect the same text variables behavior in Pcbnew. 


Here are some ideas of things that you can do with text variables: 
e Better control of PCB version numbers that appear in the silkscreen. Instead of 
using fixed text version numbers, parametrize them. 
e Standard pull-up or pull-down resistor values (or any other value you have a lot of 
in a design). Use a single text variable that makes it easy to adjust if necessary. 
e URLs for PCB usage or specification information. 


This is one of those features that once accustomed to; it is hard to think of KiCad without it. 


13.8. Board Setup - pre-defined sizes for tracks and vias 
In the layout editor, you can set the physical dimensions of tracks via and differential pairs 
in two ways: 

1. Automatically, based on the net class to which these items belong. 

2. Manually. 


In most cases, you will want to use the automatic method. You can learn more about it in 
the dedicated chapter "8.6.3. Board Setup - Design Rules and net classes". 

The manual method gives you more freedom for tracks that do not neatly fit within an ex- 
isting net class or for when you want to experiment. 

When you start Pcbnew for the first time in a project, there are no pre-defined (custom) 
track widths or via sizes. At the top menu, you can confirm this by clicking on the two drop- 
down widgets on the right side (Figure 13.8.1): 
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A Dec 


v Track: use netclass width 


Edit Pre-defined Sizes... 


Figure 13.8.1: The track width and via sizes menus in a new Pcbnew project. 


The default method for setting track and via width and size attributes is by adopting those 
specified in the item's net class. As you can see in the screenshots above, the net class 
option is the default selection in both cases. There is no other pre-defined option. But, it is 
possible to create arbitrary ones that will be available through the same menu. 

To create pre-defined track widths and via sizes, click on the last option of either drop- 
down widget, "Edit Pre-defined Sizes...". You can also click "File," "Board Setup, "and then 
"Pre-defined Classes." 

You will see the empty "Pre-defined track and via dimensions" list (Figure 13.8.2): 


o... Board Setup 

Board Stackup Pre-defined track and via dimensions: 
Board Editor Layers Tracia Vias Difforentlal Pairs 
Physical Stackup Size ] Hole Width > Via Oop 
Board Finish 
Solder Mask/Paste 

Text & Graphics 
Defaults 
Text Variables 

Design Rides 
Constraints 
Net Classes 
Custom Rules 
Violation Severity 

+ ú + ú + Š 
import Settings from Another Board. Cancel 


4 


Figure 13.8.2: The pre-defined sizes tables in a new project are empty. 


You can click on the "+" button at the bottom of each of the "Tracks", "Vias," and "Differ- 
ential Pairs" lists. 

Let's create a few pre-defined track widths. Each time, click on the "+" button at the bot- 
tom of the Tracks list. A new row will appear in the list. Click inside the new cell to set the 
cursor, and type the custom values, such as "0.15", "0.20," and "0.25". While I was at it, 
I also created custom via and differential pair sizes. Here's an example from one of my 
boards (Figure 13.8.3): 
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" 
e- o Board Setup 
Board Stackup Pre-defined track and via dimensions: 
Board Editor Layers Tracks Vias Differential Pairs 
Sowden wan 
dra Width | Size | Hole Widi Gap __ Via Gap 
Solder Mask/Paste 0.15 02 015 015 ot 01 
Text & Graphics 0.20 025 oz 
on 
Text Variables 
Design Rides 
Constraints 
Net Classes 
Custom Rules 
Violation Severity 
+ " f ú + ú 
import Settings from Another Board. Cancel 
L 


d 


Figure 13.8.3: Pre-defined sizes for tracks, vias, and differential pairs. 


When finished, click on "OK." Click on the track width and via sizes dropdown in the top 
menu, and notice that the new pre-defined sizes are now available for use (Figure 13.8.4): 


y Track: use netclass width IE va: v Via: use netclass sizes 
Track: 0.150 mm (0.00591 in) Via: 0.200 / 0.150 mm (0.00787 / 0.0 
Track: 0.200 mm (0.00787 in) Via: 0.250 / 0.200 mm (0.00984 / 0.0 


Track: 0.250 mm (0.00984 inu 


Edit Pre-defined Sizes... 


Edit Pre-defined Sizes... 


Figure 13.8.4: Pre-defined sizes for tracks and vias are now available for use. 
To use the pre-defined sizes, you can use one of the following methods: 
1. Select the size first, then create a new track via or differential pair. 
2. With the track, via, or differential pair tool already selected, you can right-click in 


the editor to bring up the context menu and then select one of the available sizes 
from the Select Track/Via Width menu (Figure 13.8.5). 
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Y Select Layer and Place Micro Via... 
Y Switch Track Posture | 
¿7 Track Corner Mode xı 


v Use Starting Track Width 
Use Net Class Values 
Use Custom Values... 


Interactive Router Settings... 


Track netclass width 
Track 0.1500 mm 
Track 0.2000 mm 


Track 0.2500 mm NS 


Via netclass values 
Via 0.2000 mm, drill 0.1500 mm 
Via 0.2500 mm, drill 0.2000 mm 


Figure 13.8.5: You can select pre-defined sizes through the context menu; this requires 
the track, via, or differential pairs tool to be enabled. 


I used the second method to draw a single track with three different track widths (Figure 
13.8.6): 


Figure 13.8.6: A single track composed of segments with different widths. 


A track like this would not be possible to draw using the automated net class method. 

In summary, while the preferred method for defining the sizes of track and vias is to have 
them inherited from the net classes (I call this the "automated" method), you have the 
option of setting custom sizes, as you learned in this chapter. 


13.9. Board Setup - Design rules violation severity 

Pcbnew contains a checker tool that can detect defects in your layout and then classify 
those defects into three categories: Errors, Warnings, and Ignore. While the default settings 
for the classifier are reasonable, you may want to experiment with alternative settings. 
Pcbnew has a tool that allows you to modify the violation severity classifier. Eeschema also 
has its own violation severity and classifier, which you can also customize (learn about it in 
the dedicated chapter "Board Setup - Design Rules and custom rules"). 

To access the Violation Severity settings, click on File, Board Setup, Violation Severity (Fig- 
ure 13.9.1). 
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Hoard Stackup 
Board Editor Layers 
Physical Stackup 
Board Finish 
Solder Mask/Paste 

Text & Graphics 
Detauhs 
Text Variables 

Design Rutes 
Constraints 
Fre-dotinod Sizes 
Net Classes 
Custom Rules 


Violation Severity 


Electrical 
items sharting two nets: 
Tracks crossing: 


Clearance violation: 


Vía is not connected or connected on only one layer 


Track has unconnected end: 


Design For Manufacturing 
Board edge clearance violation: 
Hole clearance violation: 
Drilled holes too close together: 
Track width: 
Annular width: 
Drill out of range: 
Micro via drill aut of range: 
Courtyards overlap: 
Footprint has no courtyard defined: 
Footprint has malformed courtyard: 
Board has malformed outing: 


Schematic Parity 
Duplicate footprints: 
Missing footprint: 


import Settings from Another Board. 


Board Setup 

O Error Warning 
o gmr Warning 
O Error Warning 

Error O Warning 

Error O Warning 
O Error Warning 
O Error Warning 
O Error Warning 
O Error Warning 
O Error Warning 
O Error Warning 
O Error Warning 
O Error Warning 

Error Warneng 
O Error Warning 
O Error Warning 

Error O Waning 

Error O Warning 


Ignore 
ignore 
Ignore 
ignore 


ignore 


Figure 13.9.1: The Violation Severity settings in the Board Setup window. 


In the Violation Severity settings, you can customize the classification of any of the con- 
ditions that the Design Rules Checker can identify. For example, you can classify "Hole 
clearance violation" to be an Error or a Warning. 
I will explain how the Violation Severity classifier works with the help of an example. Con- 


sider the layout below (Figure 13.9.2): 


Figure 13.9.2: I'll run the Design Rules Checker on this layout. 


The layout shown above comes from one of the projects in this book. 
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The Design Rules Checker, using the default Violation Severity settings, returns three warn- 
ings, aS you can see below (Figure 13.9.3): 


ee DRC Control 


Refill all zones before performing DRC Test for parity between PCB and schematic 
Report all errors for each track 


Violations (0)  Unconnected Items (0) Schematic Parity (3) 


» Warning: Pad missing net given by schematic (unconnected-(S1-Pad3)). 
Through hole pad 3 of S1 
Warning: Extra footprint 
Footprint REF1 R 
v Warning: Extra footprint 
Footprint G*** 


Show: All Errors © Warnings 3 Exclusions Save... 
Delete Marker Delete All Markers Close 


Figure 13.9.3: The DRC output using the default Violation Severity settings. 


There are two warnings titled "Extra footprint" that relate to the two back silkscreen layer 
logos ("Tech Explorations" and "KiCad"). These logo graphics are footprints that only exist 
in the layout, with not schematic symbol counterpart. This warning alerts me to that fact. 
I can safely ignore this warning. 

The second warning is about pad 3 of the slide switch footprint S1. I have intentionally not 
connected this pad to any nets, and the DRC warns me that it should be (connected to a 
net). 

By default, both issues are classified as Warnings. I can change this in the Violation Severity 
rules so that, for example, the "Extra footprint" issue is classified as an Error. 

Bring up the Violation Severity dialog, and look for the "Extra footprint" setting under 
"Schematic Parity." Change the severity type to "Error." The dialog should look like this 
(Figure 13.9.4): 
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ee Board Setup 
ad HER aa ULA TOA 01 cun rn meine 


Board Editor Layers 
Physical Stackup Design For Manutacturing 


Board Finish Board edge clearance violation: O Error Warning ignoro 
Solder Mask/Paste Hole clearance violation: O Error Warning ignore 
Text & Graphics R 
Oiii Drilled holes too close together: Error Warning ignore 
Text Variables Track width: O Error Warning ignore 
Design Rules Annular width: O Error Warning ignoro 
Constraints 
Drill out of range: Error ‘Warning ore 
Pre-delined Sizes ps o “4 - 
Nat Classes Micro via drill out of range: O Error Warning ignore 
Custom Rules Courtyards overlap: O Error Warning ignore 
Footprint has no courtyard defined: Error Warning O ignore 
Footprint has malformed courtyard: O Error Warning ignore 
Board has malformed outline: O Error Warning ignore 
Schematic Parity 


Signal Integrity 
Trace length out of range: O Error Warning ignore 
‘Skew betwoon traces out of ranas; O Error Warnina kanore 
Import Settings from Another Board... Cancel ca 


Figure 13.9.4: I have changed the violation severity type to "error" for the "Extra 
footprint" setting. 


Next, perform a new DRC. The result is below (Figure 13.9.5): 


o... DRC Control 


Refill all zones before performing DRC Test for parity between PCB and schematic 
Report all errors for each track 


Violations (0)  Unconnected Items (0) Schematic Parity (3) 


~ Warning: Pad missing net given by schematic (unconnected-(S1-Pad3)). 


v Error: Extra footprint 
Footprint REFI 


~ Error: Extra footprint 
Footprint G*** 


Show: All Errors E) Warnings © Exclusions Save... 
Delete Marker Delete All Markers Close 


4 


Figure 13.9.5: The two "Extra footprint" issues are now Classified as "Error." 


The DRC now classifies the two "Extra footprint" condition as errors. 

You can make similar changes to any of the conditions that the DRC can recognize. You can 
see a listing of the recognizable conditions in the Violation Severity dialog box. They are 
numerous, and they offer a basic level of flexibility for discovering and classifying violations. 
If you need more customization power, you may consider using the Custom Rules feature 
under Design Rules. You can learn more about this in a dedicated chapter. 
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13.10. Board Setup - Custom design rules 

Pcbnew allows you to customize the classification of design rules violations. You can learn 
about this in a dedicated chapter in this book. The Violation Severity dialog offer a simple 
way to change how the violation classifier works. 

If you want a much higher level of customizability in the way that the design rules checker 
work, you can use the powerful "Custom Rules" feature. 

Custom Rules allows you to write rules using a programmatic language. This language de- 
rives from S-Expressions, which invented for use in the Lisp programming language. 

Here is an example of a custom DRC rule: 


(version 1) 


# This is an example DRC rule. 

# The name of the rule is ExampleMinPowerNetClearance 

# The rule sets a minimum of 1mm clearance between a 

# track that belongs to the Power net and other elements. 


(rule ExampleMinPowerNetClearance 
(constraint clearance (min 1.0mm) ) 
(condition «A.NetClass == 'POWER'»)) 


And here is how this code looks like in the Custom Rules dialog box. You can bring up this 
box by clicking on File —> Board Setup —> Custom Rules (Figure 13.10.1): 


eve Board Setup 
Board Stuckug ORC rules: ‘Syntax help 
Board Editor Layers z (version 1) 
Physical Stackup $ la 
Board Finish * This ts an example 
Se Te nee of the hale i is “Tee enintoertettearace 
Solder Mask/Paste 5# The rule sets a minigum of lm clearance 
Text A Graphics te track that belogns to the Power net and other Princes fila 
— B irule exsnpteninrovermetclesrance 
Text Variables {constraint clearence: (nin 1.000)) 
Design Rules H (condition “A.NetC las: *POMER'")) 
Constraints 
Pre-defined Sizes 
Nat Classes 
Violation Severity 


37 — NoemorsSound 4 | 


import Settings from Another Board... Cancel =D 
L 


Figure 13.10.1: An example custom DRC rule. 


The rule starts with a version number (1). You can add comments by prepending a com- 
ments line with the "#" character (2). The rule starts with the "rule" command, followed by 
a name. In separate lines, you can define the constraint and conditions (3). There is a cus- 
tom rule validator at the bottom of the dialog box that looks for bugs in the code. You can 
invoke the validator by clicking on the "checklist" button on the right side of the validator 
output text box. In this example, my custom rule has no errors (4). 


e 217 


KiCad Like a Pro, Projects, Tips and Recipes 


You can find detailed syntax information and rule code examples in a pop-up window that 
appears when you click on "Syntax help" at the top right of the Custom Rules dialog box. 
When you write rules, take care to enclose each clause in parentheses, as per the S-Ex- 
pressions notation. 

You can define multiple conditions or constraints using booleans, or placing them in sepa- 
rate lines. Here is a modified example: 


(rule ExampleMinPowerNetClearance 
(constraint clearance (min 1.0mm)) 
(constraint track_width (max 2.0mm)) 
(condition "A.NetClass == 'POWER'") 
(condition "A.NetClass == 'Data")) 


This rule contains two constraints and two conditions, each in its line, which helps with 
clarity. 

Of course, you can create more than one custom rule. As in a program in Python or Ruby, 
you can include multiple functions in a single program file. In Pcbnew, you can add multiple 
custom rules in the DRC rules window. Here is an example: 


(version 1) 


# This is an example DRC rule. 

# The name of the rule is ExampleMinPowerNetClearance 

# The rule sets a minimum of 1mm clearance between a 

# track that belongs to the Power net and other elements. 


(rule ExampleMinPowerNetClearance 
(constraint clearance (min 1.0mm) ) 
(constraint track_width (max 2.0mm) ) 
(condition «A.NetClass == 'POWER'») 
(condition «A.NetClass == 'Data») ) 


# This is a second DRC rule. 
# The name of the rule is ExampleMinPowerNetClearance2 


(rule ExampleMinPowerNetClearance2 
(constraint clearance (min 0.5mm) ) 


(condition «A.NetClass == 'GPIO»)) 


The second rule is named ExampleMinPowerNetClearance2, and it sets a minimum clear- 
ance for tracks that belong to the GPIO net class. 


The rule editor can do code-completion. It will automatically present a list of valid keywords 
as you type. Below are some examples (Figure 13.10.2): 


e 218 


Part 13: Recipes 


DRC rules; DRC rules: 

1 (version 1) 2 (version 1) 
2 
3# This is an example ORC rule. 3% This is an example DRC rule. 
4# The name of the rule is ExanpleMinPowerNetClearance 4# The name of the rule is ExampleMinPowerNetClearance 
54 The rule sets a minimum of Imm clearance between a 5# The rule sets a minima of lan clearance between a 
6 # track that belogns to the Power net and other elements. >" track that belogns to the Power net and other elenents. 
? ‘ 
8 (rule ExampleMinPowertetClearance 8 (rule ExampleMinPowerNet(Clearance 
9 (constraint clearance (min 1.0nm)) 2 (constraint clearance 4 
18 (condition "A.Nd max 

Net Prin 

opt ad 

NetName + 

Pad_Connections 

Thickness 


DRC rules: DRC rules: 
1 (version 1) 1 (version 1) 
2 
31 This is an example ORC rule. 3e This is an exarplo DAC rule. 
4.2 The nane of the rule is ExampleMinPowertietClearance 44 The name of the rule is ExampletinPowertetClearance 
54 The rule sets a mininum of ime clearance between a 5# The rule sets a minima of ina clearance between a 
04 track that belogns to the Power net and other elements. © # Crack thet belogas to the Power eet and other elements. 
7 1 
8 (rule ExampleMinPowertietClearance B (rule Cxanp LettinPowertietC lear ance 
9 {constraint | s (constraint 
annular width 
clearances. 
courtyerd_cleatence courtyard tlearance 
dift pair gap ditt pair gap 
dift pair uncoupled dift pair uncoupled 
disattow Oisal low 
edge_clenrance edge_cleorance 
hole hole 
hole clearance hole_clearance 
hole_te hole hole_to_hote 
re SHI clearance 
sitk clearance = 
shew trek width 
track_width = 
via_count = =e 
— 2y 


Figure 13.10.2: Examples of custom rules code completion. 


I find that I can create custom rules quickly and with (usually) no errors with code com- 
pletion. 

Once you have a custom rule ready and validated, click the OK button to enable the rule(s). 
Then, test by running the DRC. Here is the output of the DRC with the custom rule that I 
listed at the start of this chapter (Figure 13.10.3): 


ee DRC Control 


Refill all zones betore performing DRC Test for parity between PCB and schematic 
Report all errors for each track 


Violations (82)  Uncomnected Items (0) Schematic Parity (3) 


v Error: Clearance violation (rul 
Track [Net-(C1-Pad2)] on F.C) 
Through hole pad 1 of 51 

+ Error: Clearance violation (rule ExampleMinPowerNetClearance clearance 1.0000 mm; actual 0.5015 mm) 
Track [Net-(C1-Pad2)] on F.Cu, length 4.0640 mm 
Through hole pad 1 of 51 

- Error: Clearance violation (rule ExampleMinPowerNetClearance clearance 1.0000 mm; actual 0.8428 mm) 
Track [Net-(C1-Pad2)] on F.Cu, length 2.8737 mm 
Through hole pad 1 of C1 

~ Error: Clearance violation (rule ExampleMinPowerNetClearance clearance 1.0000 mm; actual 0.8345 mm) 
Track [Net-(C1-Pad2)] on F.Cu, length 2.5145 mm 
Track [/3.3V] on F.Cu, length 18.1510 mm 

» Error: Clearance violation (rule ExampleMinPowerNetClearance clearance 1.0000 mm; actual 0.8428 mm) 
Track [Net-(C1-Pad2)] on F.Cu, length 2.5145 mm 
Through hole pad 1 of C2 

- Error: Clearance violation (rule ExampleMinPowerNetClearance clearance 1.0000 mm; actual 0.8345 mm) 


pearance 1.0000 mm; actual 0.5015 mm) 


Show: @ Alt Erros @ Warnings 3) Exclusions Save.. 


Delete Marker Delete All Markers Close 


Figure 13.10.3: The custom rule has generated a lot of errors 


e 219 


KiCad Like a Pro, Projects, Tips and Recipes 


As you can see, the DRC will use the name of the custom rule in its output so that you can 
identify the custom rule that fired. In this example, because the constraint that I set was 
so large (minimum clearance 1mm), the DRC generated 82 errors. Most of those errors are 
created by the custom rule. 

The Custom Rule feature is powerful, and you should use it with care. Start by looking at 
the syntax help, and become familiar with S-Expressions. Continue by writing simple rules 
for your layouts so that you can quickly become comfortable with this powerful feature. 


13.11. Schematic Setup - Electrical Rules and violation severity 

Eeschema, as Pcbnew, provides a tool that checks for violations with your design. This is 
the Electrical Rules Checker (ERC) tool, which I have used extensively in all of the projects 
in this book. 

Similar to the Design Rules Check (DRC) in Pcbnew, it is possible to change the default 
classification settings of the ERC. You can do this via the Violation Severity dialog in the 
Schematic Setup window. To learn about the Violation Severity configuration in Pcbnew, 
please look at the relevant chapter. 

You can access the Violation Severity dialog in Eeschema, click File —> Schematic Setup 
—> Violation Severity (in the Electrical Rule group). The dialog box looks like this (Figure 
13.11.1): 


o o Schematic Setup 
General Connections 
Formatting 
Flekl Name Templates Pin not connected: O Error Warning Ignore 
Electrical Rules Input pin not driven by any Output pins: O Error Warning Ignore 
Input Power pin not driven by any Output Power pins: O Error Warning Ignore 
Pin Conflicts Map A 5 z E 
Project A pin with a “no connection* flag is connected: Error O Warning Ignora 
Net Classes Unconnected "no connection" flag: Error O Warning lanore 
Text Variables Label not connected to anything: O Error Warning Ignore 
Global label not connected anywhere else in the schematic: Error O Warning Ignore 
Wires not connected to anything: O Error Warning Ignora 
Bus Entry needed: O Error Warning Ignore 
Conflicts 
Duplicate reference designators: O Error Warning Ignore 
Units of same symbol have different values: O Error Warning Ignore 
Different footprint assigned in another unit of the symbol: O Error Warning Ignore 
Different net assigned to a shared pin in another unit of the symbol: © Error Warning Ignore 
Duplicate sheet names within a given sheet: O Error Warning Ignora 
Mismatch between hierarchical labels and sheet pins: O Error Warning Ignore 
More than one name given to this bus or net: Error O Warning Ignore 
Conflict between bus alias definitions across schematic sheets: O Error Warning Ignore 
Buses are graphically connected but share no bus members; O Error Warning ignore 
PA A A Crone Minenine innara 
Import Settings from Another Project... Cancel 


Figure 13.11.1: The Violation Severity dialog box in Pcbnew. 


The default settings are reasonable, and you will rarely need to make any changes. 

Let's look at an example to help you understand how you can change the classification of a 
violation during an ERC. In my test schematic below, I have introduced a defect by deleting 
a wire segment (Figure 13.11.2). 
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Figure 13.11.2: An evident defect: a wire segment is missing. 


Under " Connections, " the violation at the very top of the list, under "Connections," is "Pin 
not connected." The default classification for this violation is "Error." Go ahead and change 
this to "Warning" (Figure 13.11.3): 


ee Schematic Setup 
- General 
Formatting -onnection: 
sl Noms Tampines 
aL input pin not driven by any pins: O Ero Warning ignore 
cola Input Power pin not driven by any it Power pins: O Error Warning Ignore 
~ Project A pin with a "no connection" flag is connected: Error O Warning Ignore 
ii Unconnected *no connection" flag: Error O Warning Ignore 
Label not connected to anything: © Error Warning Ignore 
Global label not connected anywhere else in the schematic: Error O Warning Ignore 
Wires not connected to anything: O Error Warning Ignore 
Bus Entry needed: O Error Warning Ignore 
Conflicts 
Duplicate reference designators: O Error Warning Ignore 
Units of same symbol have different values: O Error Warning Ignore 
Different footprint assigned in another unit of the symbol: O Error Warning Ignore 
Different net assigned to a shared pin in another unit of the symbol: © Error Warning Ignore 
Duplicate sheet names within a given sheet: O Error Warning ignore 
Mismatch between hierarchical labels and sheet pins: O Error Warning Ignore 
More than one name given to this bus or net: Error O Warning lgnore 
Conflict between bus alías definitions across schematic sheets: © Error Warning Ignore 
Buses are graphically connected but share no bus members: O Eror Warning Ignore 
Import Settings from Another Project... Cancel 


Figure 13.11.3: Changed classification of "Pin not connected" to "Warning." 
Let's see the impact of this change on the way that the ERC classifies schematic violations. 


Bring up the ERC window (Inspect —> Electrical Rules Checker) and click on "Run ERC." 
You can see the result below (Figure 13.11.4): 


e 221 


KiCad Like a Pro, Projects, Tips and Recipes 


e Electrical Rules Checker 


Gym MEGAS28P 
Symbol U4 [ATMEGA328P-AU] 


shom © All Gere QD warnings © © Exctusions Save, 


Delete Markers Close 
Se | 


Figure 13.11.4: The ERC lists the missing wire segment 
as "Pin not connected" and a warning. 


The ERC lists the missing wire segment as "Pin not connected,” classified as a "Warning." 
Notice that in this ERC, the total number of errors is zero. 

Change the "Pin not connected" classification back to its original "Error," and repeat the 
ERC. The result is below (Figure 13.11.5). 


3 


7 Show: © All © Warnings “GT 0 Exetusions Save... 


| Delete Markers cos EE 
| 


Figure 13.11.5: The ERC lists the missing wire segment as 
"Pin not connected" and an error. 


The same violation that was previously listed as a Warning is now listed as an Error. 
Notice that unlike Pcbnew and the DRC, the ERC does not prepend a violation with its clas- 
sification. For example, the DRC reports a "Warning" like this: 

Warning: Missing footprint 
However, an ERC violation looks like this: 

Pin not connected 
In the ERC, there is no explicit mention of the kind of violation that it is. You can derive this 


information by looking at the accumulated numbers of Errors, Warnings, and Exclusions at 
the bottom of the ERC window. 
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You can further customize the ERC by looking at the Pin Conflicts Map dialog box. This al- 
lows you to set violation classifications for the various pin to pin conditions. You can learn 
about this in a dedicated chapter. 


13.12. Schematic Setup - Electrical Rules and Pin conflicts map 

The Pin Conflicts Map dialog box (found in the Schematic Setup window, under Electrical 
Rules) allows you to set violation classifications for the various pin to pin conditions. 

To access this dialog go to File, Schematic Setup, and click on "Pin Conflicts Map" under 
"Electrical Rules." The user interface of this tool resembles an assignment triangle. The in- 
tersecting points between columns and rows are buttons. Each time you click on a button, 
you can change its value into one of three possible values: 


: a No error or warning. 
E A Generate warning. 
E dh Generate error. 


Let's look at an example. 
Bring up the Pin Conflicts Map dialog box. It looks like this (Figure 13.12.1): 


e o Schematic Setup 
General Pin to Pin Connections 
Formatting 
Fleld Name Templates ie 
Electrical Rules È 
Violation Severity Input Pin Crap Pia 


Pin Conflicts 
Project 
Net Classes 
Toxt Variables Bidirectional Pin 


im A ee 
passivo ph SEBS MEER 
Fern MY UD Go a Ult 

Unepecitied Pin A AALAAMA Pam 
Power inputen MY Y A A e 
powerouwutrn M OJA O DOADO wor 
Open colector A O D A aao o 

open Emitter BOAARBBABOBSB Ita 
no Comecion 9 OOOO000000 


Map 


«o e pla i directional Pin 


Tri-State Pin 


Reset to Defaults Import Settings from Another Project... Cancel 


Figure 13.12.1: The Pin Conflicts Map 


In this example, I have highlighted the conflict classification for a connection between two 
pins designated as outputs. The classification of this type of connection is "Generate error." 
Similarly, a connection between an open connector pin and an output pin will generate an 
error. 
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Also, notice that the last row of the triangle is set to generate errors for all not connected 
pins. In my test schematic, I have left pin 23 unconnected, and the ERC lists this as an error 
(Figure 13.12.2): 


Figure 13.12.2: ERC reports an unconnected pin error. 


Let's do a quick experiment that uses this test schematic (Figure 13.12.2): 


Passive 


0.4 uF Input 


+ Ab 


Figure 13.12.2: A connection between a passive and an input pin. 
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In this example, there is a connection between a capacitor pin (set as "passive" in the sym- 
bol properties) and pin 20 of the Atmega328P symbol, which is designated as "input." You 
can check the pin type by double-clicking on the symbol to bring up its properties window 
and click on Edit Symbol (Figure 13.12.3). 


ATMEGA328 


InputG 


Bidirectional@ 
Bidirectionalo 


BidirectionalG 


Figure 13.12.3: The type of pins that are connected in my test schematic. 


As you can see in figure 13.12.1, the classification for connection between passive and in- 
put pins is "green"; therefore, no error or warning is generated. Truthfully, when I ran the 
ERC earlier (see Figure 13.12.2), the ERC did not list any relevant violations. 

Let's change this classification. Open the Pin Conflicts Map, and click on the button in the 
junction of the Passive Pin row and Input Pin column to show the red "!" mark 

(see Figure 13.12.4). 


e.e Schematic Setup 


~ General Pin to Pin Connections 
Formatting 
Fleld Namo Templates T Pin 
Electrical Rules 
Violation Severity input pin MY Suerte 


- Project Output Pin a JN 
sab Bidirectional pin MY MY UY oe 
sn A Tea 
sor O ™" 
rro pin MY Y MD MD O O rene 
Unspectied Po A AA A A BA A 
Powerinpur rn MY LA A o 
rmcomirn BOAOEEBABO TO 
opencatecior BORABBABOB Pue 
one BOAABBABOBB om” 
no Connection @9OOOOOOOOO0O 


Reset to Defaults Import Settings from Another Project... Cancel 


Figure 13.12.4: Passive to input pin connections are now classified as "error". 


Click OK, and rerun the ERC. Here is the result (see Figure 13.12.5): 
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04 uf 


D8_12 


13 Shomi — 


~- 14 


Pins of type Passive and Input are connected 
Symbol DT! (Battary} Pin 2 (>, Passiva, Liew) 
‘Symbet U3 [24LC i] Pin 2 (Ad, int, Lina] 

Pins of type Passive and Input are connected 
Dymbel BTY (Battery) Pin 2 [~ Passiva, Liew) 
Symbal UF [2401028] Pin 7 (We, mput, Line} 


~ Pins of type Passive and input are connected 


Symbol BTI [Hattarys Pin 2 +, Paasto, Lina] 
Symibee UI [24LC1028) Pin 7 [WP, Input, Line} 


- Pins of type Passive and input are connected 


Symbol BT) (Battery) Pin 3 f+, Passten, Line 
Symbol UI [24LC1028) Pin 1 (40, Input, Line] 


© Bing af tuna Daccius and innast are nnnnartad 


AA AS 


Doete Markmra 


Excusiona 


Seve, 


core MO 


Figure 13.12.5: Passive to input pin connection errors are detected by the ERC. 


The ERC has detected a large number of passive to input pin errors. One of them is the one 
between the capacitor in pin 20 of the Atmega328P. I don't want this kind of connection to 
be classified as an error, so I have restored the violation classification as "green." 

The Pin Conflicts Map gives you another way to customize the operation of the ERC. When 
used with care and consideration, it can be another way to ensure that KiCad fits well with 
the specific requirements of your project. 


13.13. Field name templates 
"Field name templates" is a new feature in KiCad 6. With this feature, you can add custom 
fields to the list of symbol field properties and complement the pre-defined ones. 


Here is an example of the properties for one of the symbols in my test schematic, the 
DS1337S+ real-time clock (Figure 13.13.1): 


eee Symbol Properties 
General Alternate Pin Assignments 
Fields 
Name Show H Align V Align italic Bold Text Size 
Reference U2 Center Center 127 
Value DS1337S+ Center Center 1.27 
Footprint Footprints:SOIC127P600X175-8N Left Bottom 1.27 
Datasheet Left Bottom 1.27 
+t he " 
General Pin Text Update Symbol from Library... 
C arie pin nomesis Change Symbol 
Show pin names ab A ar 
Edit Symbol... 
0 e Attributes 
Angle: 
Mirror; Not mirrored Exclude from bill of materials Edit Library Symbol 
Exclude from board == 
Library link; DS13375_:DS1337S+ Spice Model... Cancel 


Figure 13.13.1: The Symbol Properties window showing the pre-defined fields. 
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If you wish to add other fields to this list, you can use the Field Name Templates feature. 
For example, you may want to add: 
e a "Description" field, where you can type a short description for the function of the 
component, 


Your custom field name templates will be shared among all symbols in the project. 
e a "source" field so that you add the URL for an online retailer from where you can 
purchase the component, 
e or a "Wikipedia" field where you can copy the URL of a Wikipedia article relevant to 
the component. 


Your custom field name templates are shared among all symbols in the project. 
There are two locations where you can define custom field name templates. 
e Local project level, via File —> Schematic Setup —> Field Name Templates 
e Global project level, via KiCad —> Preferences —> Field Name Templates 


Both work in the same way. The only difference is that any field names created in the Sche- 
matic Setup window will be available only in the current project. In contrast, those made in 
the Preferences window will be available to all projects. 

Let's look at an example using the local project level option. 

Bring up the Schematic Setup window (File —> Schematic Setup) and click on Field Name 
Templates. Click on the "+" button twice at the bottom of the window to create two new 
rows. Then type the names for the new fields (Figure 13.13.2): 


e o Schematic Setup 


General Project field name templates: 
Formatting Name Visible 


Description (in Schematic Setup) 
Wikipedia 


Electrical Rules 
Violation Severity 
Pin Conflicts Map 

Project 
Not Classes 
Text Variables 


+ 3 


Import Settings from Another Project.. Cancel 


Figure 13.13.2: Two new field name templates. 


The two new fields names are "Description (in Schematic Setup)" and "Wikipedia." 
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Two checkboxes control the new field's value visibility in the schematic editor ("Visible") 
and set the value as a URL so that when you click on it, the URL is copied to a browser 
("URL"). I have enabled visibility for the first field and the URL checkbox for the second. 
Click OK to commit the new fields, and return to the editor. In the editor, double-click 
on any of your symbols to bring up its properties. Below, I show the properties of the 
DS1337S+ IC. I have added some text in the new fields (Figure 13.13.3): 


eee Symbol Properties 


General Alternate Pin Assignments 
Fields 


Name Value Show H Align V Align italic Bold Text Size 
Referance U2 Center Center 1.27 
Value DS1337S+ Center Center 1.27 
Footprint Footprints:SOIC127P600X175-8N Left Bottom 1.27 


Datasheet Left Bottom 1.27 
re ; wh Center Center 1.27 
Center Center 1.27 


+t ie u 
E a Update Symbol from Library... 
Show pin numbers = aE 
Show pin names ange Symon... 
Attribu Edit Symbol... 
ttributes 
Angle: 0 e 
Mirror: Not mirrored Exclude from bill of materials == 
bi l. 
Exclude from board Edit Library Symbol 
Library link: 0S1337S_:DS1337S+ Spice Model... Cancel RD 


Figure 13.13.3: Two new fields appear in the Symbol Properties field. 


The value in the Wikipedia field includes a globe icon to indicate that it is clickable. When 
you click on this globe, the URL opens up a web browser to the page specified. The "Show" 
checkbox for the Description is checked to display the text value in the schematic. To show 
you how the URL looks in the schematic, I have also enabled the Wikipedia "Show" check- 
box (though I did not capture this in the screenshot of Figure 13.13.3). Click OK to dismiss 
the Symbol Properties window and return to the editor. Below you can see how the two new 
field values look like (Figure 13.13.4): 
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Vec PWR_FLAG 


U2 
DS1337S+ 


https://en.wikipedia.org/wiki/Real—time_clock GND 
This Is a clock IC so that my PCB/gadget can keep time. 


Figure 13.13.4: The values of the new fields in the schematic editor. 


Let's try out the second option at the global project level. Click on KiCad —> Preferences 
—> Field Name Templates. Click on the «+» button once to create a new field, and give it 
the name «Description (in KiCad Preferences).» I have added the qualification to differen- 
tiate between this field and the one I created earlier at the project level. The window looks 
like this (Figure 13.13.5): 


[= z Preterences 
Common O a 
Mouse and Touchpad — _— — 
Hotkeys — : 
Schematic Editor IST {in KiCad preferences) Pe S 
Display Options 
Editing Options 
Colors 


coce MD 
Figure 13.13.5: A new field template at the global level. 
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Click OK to return to the editor, then double-click on a symbol to bring up its 


properties. 


You will notice that the new field appears below the one you created earlier at the project 
level. Enter some text in the new field. Here is mine, in the Symbol Properties field for the 


DS1337S+ IC component (Figure 13.13.6): 


eee Symbol Properties 
General Alternate Pin Assignments 
Fields 
Name ] Value Show H Align V Align Italic Bold Text Size 
Value DS1337S+ Center Center 1.27 
Footprint Footprints:SOIC127P600X175- Left Bottom 1.27 
Datasheet Left Bottom 1,27 
Description (in Schematic Setup) This Is a clock IC so that my PC Center Center 1.27 
Wikipedia https://en.wikipedia.org/wiki/Re Center Center 1.27 
Description (in KiCad preferences) Center Center 1.27 
a O BY " 
Sicha Ein t Update Symbol from Library... 
Show pin numbers =r mee 
an mbol... 
Show pin names ol 
Edit Symbol... 
A Attributes 
Angle: 0 
Mirror: Not mirrored Exclude from bill of materials 
Edit Libi Symbol... 
Exclude from board seat a 
Library link: DS1337S_:DS1337S+ Spice Model... Cancel 


Figure 13.13.6: The new global field name template. 


Click OK to return to the editor, and see the global "description" field value in the new field 


next to its symbol (Figure 13.13.7): 


SCK 5 


“INTA 
SQW/"INT 


Y1 
32.768 KHz 


SDA 


Here is some more info... 
https: //en.wikipedia.org/wiki/Real-— 
This is a clock IC so that my |PCB/gadget can keep time. 


Figure 13.13.7: The new global field value. 
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You can add any number of project or global field name templates to incorporate helpful 
information. A handy application for those custom fields is that you can included them in 
the bill of materials (BOM). To learn more about BOM and how you can generate one in 
KiCad, please read the dedicated chapter. 


13.14. Bill of Materials 

Once you have completed the design of your printed circuit board and you are ready to 
manufacture it, you may want to consider exporting a bill of materials. A bill of materials 
("BOM") is a list of the raw components, along with meta-data like their quantity, values, 
designators, and sources, that an end-user of your PCB will need to complete the assembly 
process and deliver a finished product. 

KiCad can generate a BOM "out of the box" without a need for external plugins. It is also 
possible to use third-party plugins to generate a BOM. In this chapter, I will show you both 
options. 

In the first instance, there are two build-in methods for generating a BOM. I will also show 
you the same using a plugin. 


13.14.1. Build-in BOM in Pcbnew 
Pcbnew offers the most straightforward method for generating a BOM. It is available 
through the File menu. Click on File —> Fabrication Outputs —> BOM (Figure 13.14.1.1). 


a Es 
El E 1 BW save copy as... PQQQQQ NG 


Track: use net jetclass sizes Grid: 2.5400 mm (0.1000 i 


Rescue 


Figure 13.14.1.1: The BOM fabrication output function in Pcbnew. 


This function will ask you for a location and name for the new CSV text BOM file and save 
this file in your computer's file system. In my example below, I have this file the name 
"MCUCataloggerBOM.csv" (Figure 13.14.1.2). 


ZE MCU Datalogger.kicad_sch 95KB oesche...ocument 
MCU Datalogger.rules Doc 
MCU Datalogger.ses 


= MCU Datalogger.xml 35KB XN 
net_inspection_fiort.csv 2KB CSV Document 
NetinspectorReport.csv 2KB CSV Document 


Figure 13.14.1.2: The new CSV BOM file. 
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Open it with a text editor to see its data. You can see it below in the Atom editor (Figure 
13.14.1.3): 


pee MCUDatalogger_bom.csv — ~/Documents/Kicad/Course development documents/KiCad Like a Pro 3e Projects/MCU Datalogger 

leli MCUDatelogger_bom.... x 

1 "Id";"Designator"; "Package"; "Quantity";"Designation";"Supplier and ref"; 
2 1;"H4,H1,H2,H3";"MountingHole_2. 1mm"; 4;"MountingHole"; ; ; 

3 2;"R1,R6,R2";'"R_0805_2012Metric";3;"10K";;; 

4 3;"U3,U1";"SOIC-8_5.23x5.23mm_P1.27mm";2;"24LC1025";;; 

5 4;"R4,R3";"R_@805_2012Metric";2;"4.7K";;; 

6 5;"C1,C4";"C_@805_2012Metric";2;"0.1uF";;; 

7 6;"J3,31";"PinHeader_1x04_P2.54mm_Vertical";2;"Conn_01x04_Male";;; 

8 7;"C2,C3";"C_0805_2012Metric";2;"22pF";;; 

9 8;'"D1,D2";"LED_0805_2012Metric";2;"LED";;; 
10 9;"R7,R5";"R_0805_20p2Metric";2;""330"; 7; 
11 10;'"J4";"PinHeader_2x03_P2.54mm_Vertical";1;'Conn_02x03_0dd_Even";;; 
12 11;"Y2";"Crystal_SMD_5032-2Pin_5.0x3.2mm_HandSoldering";1;"16 MHz";;; 
13 12;"BT1";"PinHeader_1x@2_P2.54mm_Vertical";1;"Battery";;; 
14 13;"C5";'"C_0805_2012Metric";1;"100nF";;; 
15 14;"U4";"0QFP80P900X900X120-32N";1;"ATMEGA328P-AU";;; 
16 15;"J2";"PinHeader_1x09_P2.54mm_Vertical";1;'"Conn_01x09_Male";;; 
17 16;"U2";"SOIC127P600X175-8N";1;"DS13375+";;; 
18 17;"Y1";"Crystal_SMD_5032-2Pin_5.0x3.2mm_HandSoldering";1;'32.768 KHz";;; 
19 18;"G2";""TE_Logo_11.6x4";1;"LOGO"; ;; 
20 19;"Gixx*'";"TE_Logo_10mm_negative_silkscreen";1;"LOG0";;; 


ps NA DECI Ha ME CSA Lon Emm CillCeraontls Ta tiri sd I aons? Emm CillCeranolls.s. 7 = 
|—/Docurnents/Kicad/Course development documents/KiCad Like a Pr. LF UTF-8 Plain Text P 2i-experimental @Noremote €) GitHub ©Gir(3} C 5updəies e 


Figure 13.14.1.3: The contents of the CSV BOM file from Pcbnew. 


This BOM file contains the fundamental bits of information about the components of the 
PCB circuit: 
e ID. 
e Designator. 
e Package. 
Quantity. 
e Designation. 
e Supplier and ref. 


The BOM does not contain any additional build-in or custom component properties. I re- 
mind you that a symbol in Eeschema can hold any number of fields, as you can see in this 
example (Figure 13.14.1.4): 
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eee Symbol Properties 
General Alternate Pin Assignments 

Flelds 

Name Value Show HAlign VAlign itale Bold Textsize 
Reference va Center Center 1.27 

Value DS1337S+ Center Center 1.27 
Footprint Footprints:SOIC127P600X175-8N Left Bottom 1.27 
Datasheet Left Bottom 127 
Purpose Test string in purpose field Center Center 12 
Wikipedia URL https://en.wikipedia.org/wiki/Real-time_clock Center Center 127 


Wee Not in BOM 


+14 he ' 
ti es Update Symbol from Library... 
Show pin numbers 
hal ie 
Show pin Change Symbol. 
Edit Symbol... 
A Attributes 
Angie: 0 
Mirror: Not mirrored Exclude from bill of materials 
Exclude from Edit Library Symbol... 
Library link: 0$1337S_;081337S+ Spice Model... Cancel 


Figure 13.14.1.4: These three fields do not appear in the BOM CSV file from Pcbnew. 


In the example above, the three fields at the bottom of the Fields list do not appear in the 
BOM file I just exported. One of the missing fields ("Datasheet") is built-in, and the other 
two are custom. I will show you how to include any number of fields in the BOM file using 


the new two BOM methods. 


The exported BOM file is a simple text CSV file. You can open it using a spreadsheet applica- 
tion like Microsoft Excel or Google Sheets. This how it looks like in Excel (Figure 13.14.1.5): 


Home insert Draw  PageLayout Formulas 
B6 > fe 
A B c 

1 Id Designator Package 

2 | 1 H&H1H2,H3 MountingHole_2.1mm 

3 | 2 RLR6R2 R_0805_2012Metric 

4 | 3U3U1 SOIC-8_5.23x5.23mm_P1.27mm 

5 | 4 R4R3 R_0805_2012Metric 

6 | s[cica (C_0805_2012Metric 

7 | 6331 PinHeader_1x04_P2.54mm_Vertical 

B| 7 c23 C_0805_2012Metric 

9 | 8 D1,D2 LED_0805_2012Metric 

10. 9 R7,R5 R_0805_2012Metric 

11 |10 J4 PinHeader_2x03_P2.54mm_Vertical 

12 |11 Y2 Crystal_SMD_5032-2Pin_5.0x3.2mm_HandSoldering 
13 12 BT1 PinHeader_1x02_P2.54mm_Vertical 

14 |13 c5 C_0805_2012Metric 
115/14 U4 QFP80P900X900X120-32N 
116 1532 PinHeader_1x09_P2.54mm_Vertical 
117 16 U2 SOIC127P600X175-8N 

18117 Y1 Crystal_SMD_5032-2Pin_5.0x3.2mm_HandSoldering 
19 18 G2 TE_Logo_11.6x4 

0/19/65 TE_Logo_10mm_negative_silkscreen 
h | 20 REF1 KiCad-Logo2_5mm_SilkScreen 
23 


View 


Review 


Data 


D E 
Quantity Designation 
4 MountingHole 
3 10K 
2 241C1025 
2 4.7K 
2 0.1uF 
2 Conn_01x04_Male 
2 22pF 
2 LED 
2 + 330 
1 Conn_02x03_OddUven 
1 16 MHz 
1 Battery 
1 100nF 
1 ATMEGA328P-AU 
1 Conn_01x09_Male 
1 DS1337S+ 
1 32.768 KHz 
1 LOGO 
1 LOGO 
1 KiCad-Logo2_5mm_SilkScreen 


Supplier and ref 


F G 


Figure 13.14.1.5: The BOM file in Excel. 
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You can use this spreadsheet instance of the BOM to add or edit the information before you 
share it with other people or upload it to a manufacturing facility. 

This method is quick and straightforward to use, but as I mentioned above, it lacks flexibil- 
ity. Next, I'll show you the second build-in BOM generator that KiCad offers that provides 
more flexibility while being somewhat more complicated to use. 


13.14.2. Build-in BOM in Eeschema 

The second method for generating a BOM that KiCad offer is available in Eeschema. The 
functionality we need is "hidden" inside the Edit Symbol Fields window. In Eeschema, click 
on Tools —> Edit Symbol Fields (Figure 13.14.2.6). You can ignore the "Generate BOM" 
option in the same menu. Even though it looks like the one we want, it requires a plugin to 
work. I will show you an equivalent (but better) option later. 


KiCad File Edit View Place Inspect Tools Preferences Help Window 


ne de Update PCB from Schematic... 
ASsblerm ot B® A Bb update schematic trom PCB... 2 > 41m 


BB) switch to pcs Editor 


By Symbol Editor 
/ Update Symbols from Libr 
i Up ymbols ary... : I 


2? o Rescue Symbols... 
a 
a 


* 
> Click => $22 Edit Symbol Fields.. vee PR 
E Qy Edit synMbol Library Links... | | 


ya Annotate Schematic... 
Ka Bus Definitions... 


ib Assign Footprints... 


Ignore es e+) Generate BOM... 


Figure 13.14.2.6: In Eeschema, the BOM generator 
hides in the Edit Symbol Fields window. 


This will bring up the Edit Symbol Fields window. This window offers a convenient way to 
edit the information of any of the symbol property fields, for any symbol, in bulk. You can 
edit the values of any field or even create custom fields. This editor can save you a lot of 
time from going into each symbol properties window and then editing the field values one 
at a time. 

In this scenario, I want to generate a BOM that contains a combination of built-in and cus- 
tom fields. In the left pane is a list of the available fields with radio buttons (1). The "Show" 
radio button controls if a given field will appear in the table in the main pane (2). In this 
example, I have enabled all "show" fields except for "MANUFACTURER." As I enable and 
disable the Show checkboxes, the main pane updates its contents. 

In the main pane, you can also re-arrange the columns in any order you like. Simply click 
on the column's header and hold the button down while dragging the entire column to a 
new position. 
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When you are ready to export the data, click on the top-most field, hold down the shift 
key to enable multiple-select, and click again on the bottom right corner field. This works 
in the same way as when you do a multiple-select operation in a spreadsheet. When all 
fields are highlighted with a blue background, type Ctr-C or Cmd-C (Windows, Mac), or do 
a right-click to reveal the context menu and select Copy. You can see all this in the example 
screenshot below (Figure 13.14.2.7): 


i 
so sacaf 


At Ft 


Artt tom Ectamaros A Certrao cot | 


Figure 13.14.2.7: In Eeschema you can export BOM data from 
the Edit Symbol Fields window via a copy operation. 


At this point, you have copied the BOM data in a comma-delimited format in your comput- 
er's clipboard. Now you want to paste the data into a spreadsheet or text editor. Below, I 
have pasted (Ctrl-V or Cmd-V) the copied data to Excel (Figure 13.14.2.8): 


Home insert Draw  PageLayout Formulas Data Review View 
: Se 
A b £ E F c 
Bi at Battery Connector _PinHeader_2 Simm PirHeader 2x02 P254mm Vertical ~ 
2? >a, ow Capacitor SMOxC_0805_2012Metric > 
1>00 2e Capacitor SMOC 0805 _2012Metric ~ 
M 5 1000F Capacitor_5MO:C_0805_2012Metric > 
ls > 01,02 uD LED_SMDAED_0805_2012Metric - 
6 > Hi MountingHole MountingHole:MourtingHobe_2.t:mm 2 
7) a Conn OIA Male Connector PinHeader_2 $4mmPiHeader 1x09 P2.54mm_Vertical ~ cha 
le > 14,93 Corm_01:04_Male Connector Pintweadter_2 Smm Prende 1:04 P2.54mm Vertical ~ ~ mined veses ~- 
pos Comm_02x03_Odd Even Conmector_PinMeader_2.S4mmPirkoader_2:03_P2.54mm_Vertical ~ Ksp 
0 > RL, RZ RG 10% Resistor_SMO:N_0805_2012Metrie = 
1 > 83,04 am Resistor SMO _OBOS_ 2012Metrkc = 
L2 > 85, R7 330 Resistor _SMOR_0805_2012Metrie > 
3 > UL UI mcos Packaye_SO:SOIC-B_5.23x5.23mm_P127mm ‘nttpy/ ww 1.microchip.com (downloads /en/ DevicwDoc/219418. pat 
A va ATMEGA323P-AU Foonprints QF PROPICOIDOOX1 20-320 Atmel 
s| vı 32.768 KH: Crystak-Crystal _SMD_5032-2Pin_5.03.2mm _Handsoidering = 
io) v2 16 Mite Crystal Crystal_5M0_5032-2Pim_5.0:).2mm_HandSciclering 
7) uz 05133754 Footprints SOIC 27PE00X175-2N Test string in purposo tioii httpe// 
$ 
5 
0 
1 


Figure 13.14.2.8: Edit Symbol Field data copied into Excel. 


Notice from the screenshot above that the header of the BOM is missing. The header is 
not included in the data copied from the Edit Symbol Field window. You will need to add 
the header manually in Excel. Just insert a new row at the top of the table, and type in the 
appropriate column title. 

The data are still in the clipboard, so you can try paying in a text editor. Below is a screen- 
shot from my paste operation in the Atom text editor (Figure 13.14.2.9): 
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lilt vcunamgga sen x 


BT1 Battery Connector_PinHeader_2.54mm:PinHeader_1x02_P2.54mm_Vertical ~ 


umitisd — -Desktop 


inimes o 


C1, C4 0.1uF Capacitor_SMD:C_0805_2012Metric ~ 

C2, C3 22pF Capacitor SMD:C_0805_2012Metric ~ 

100nF Capacitor_SMD:C_0805_2012Metric ~ 

D1, D2 LED LED_SMD:LED_0805_2012Metric ~ 

H1-H4 MountingHole MountingHole:MountingHole_2. 1em ~ 
Conn_01x09_Mate Connector_PinHeader_2.54mmtPinHeader_1x09_P2.54mm_Vertical ~ GPIO 
J1, J3 Conn_01x04_Male Connector_PinHeader_2.54mm:PinHeader_1x04_P2.54mm Vertical ~ 
Conn_02x03_0dd_Even Connector_PinHeader_2.54mm:PinHeader_2x03_P2.54mm_Vertical ~ 
R1, R2, R6 10K Resistor _SMD:R_0805_2012Metric ~ 

R3, R4 4.7K Resistor_SMD:R_@805_2012Metric ~ 

RS, R7 330 Resistor_S5MD;R_0805_2012Metric ~ 

U1, U3 24LC1025 Package_50:S0IC-8_5.23x5.23mm_P1.27mm http://wwi.microchip.com/downloads/en/DeviceDoc/ 219418. pdf 
ATMEGA328P-AU Footprints: QFP8OP900X900X128-32N Atmel 

32.768 KHz Crystal:Crystal_SMD_5@32-2Pin_5.0@x3.2em_HandSoldering ~ 

16 MHz Crystal:Crystal_SMD_5032-2Pin_5.0x3.28m_HandSoldering ~ 

D513375+ Footprints:S01C127P500X175-BN Test string in purpose field https://en.wikipedia,org/wiki/Real-time_clock 


I 


— mixed values — 
ICSP 


Figure 13.14.2.9: Edit Symbol Field data copied into a text editor. 


From there, you can use this spreadsheet or text editor instance of the BOM to add or 
edit the information before you share it with other people or upload it to a manufacturing 
facility. 
There's one more BOM generator method that I will show that involves using a third-party 
plugin. The plugin itself provides a powerful way of BOM generation and an opportunity to 
learn how to install and use a plugin in KiCad 6. 


13.14.3. A plug-in for BOM 

KiCad build-in functionality can be extended with the use of external plugins. 1 will show 
you how to use one such plugin to generate a BOM for your project in this segment. The 
plugin I will use is "Interactive HTML BOM," and you can find it in Github at https://github. 
com/openscopeproject/InteractiveHtmliBom (Figure 13.14.3.10). 


e... y = © e tte aaa o+ 0 
O coemccoegregectitnecactivertirai@or meracia HTA BOM pe 
A openscopeproject / InteractiveHtmiBom Wsch = 87 Ly aw AT Yrok vs 
<> Code issues 20 Pull requests 3 Actions wa Security Insights 
F master- =P 1 branch O10 tags Go to file Add file + About 
interactive HTML BOM generation 
1B) wick ignore visibility on PTEXT (kicad) = snesei? 4 hours ago 276 commits plugin for KiCad 
E tteractiveHtmiBom ignore visibility on PTEXT (kicad 4 hours ago mes pooner ecita-puen 
bom-tool 
™ icons Switch to using bitmaps in small buttons 17 days ago 
O Reade 
aitignore Use wxformbullder 3.9.0 15 months ago fete 
5 MIT cen: 
[ jabeautityre Add jsbeautifre and autoformat web essets = EE 
DATAFORMAT md Revert removed description of rect trom schema 
Releases 10 
LICENSE Add LICENSE 3 yew 
Look squigglies | Latest 
README.md Mention support of other ecad packages in readme months ago o =$ Soo ies: oe 
"it py Don't crash when netlisipari is malformed years ago Cana 
settings_dialog.fbp Refactor extra fields handling 5 days ago 
Packages 
tees amd 


Figure 13.14.3.10: The "Interactive HTML BOM" plugin project on Github. 
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This plugin contains excellent documentation and also supports the EasyEDA and Fusion360 
CAD applications. I encourage you to take a few minutes to review the information in the 
project wiki (https://github.com/openscopeproject/InteractiveHtmIBom/wiki). This wiki is 
the source of the information I used to learn how to install the plugin to my KiCad instance 
and use it. 

KiCad can look for plugins in several folders, and the exact locations can vary between 
operating systems. They also depend on how you installed KiCad on your computer. The 
most reliable way to find out the correct plugin folder(s) for your KiCad instance is to use 
the Python scripting console and run a couple of lines of code. 

First, bring up the Python scripting console. To do that, in Pcbnew, click on Tools —> Script- 
ing Console (Figure 13.14.3.11). 


File Edit View Place Route Inspect Tools Preferences Help Window 


ap Update PCB from Schematic... 


2 S a Q ( + Switch to Schematic Editor 


use netclass width Via: use netclass sizes 


Eg) Footprint Editor 


onsole 


A i - 
Figure 13.14.3.11: The Python Scripting Console option in the Tools menu in Pcbnew. 


This will bring up the console. The console contains the main pane on the top side ("shell"), 
where you can enter Python code and see the interpreter responses. You can ignore the 
tabs in the bottom pane as you don't need them for this operation. In the shell, type these 
two command lines: 


>>> import pcbnew 

>>> print (pcbnew.PLUGIN_DIRECTORIES_SEARCH) 

When you commit the second line, the following text will appear in the shell: 
/Applications/KiCad/KiCad.app/Contents/SharedSupport/scripting 
/Applications/KiCad/KiCad.app/Contents/SharedSupport/scripting/plugins 
/Users/peter/Library/Preferences/kicad/5.99/scripting 
/Users/peter/Library/Preferences/kicad/5.99/scripting/plugins 
/Users/peter/Documents/KiCad/5.99/scripting 
/Users/peter/Documents/KiCad/5.99/scripting/plugins 

>>> 
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The output you see in your shell will be different from mine. In the example above, there 
are more than one folders that I can use to store plugins. I prefer to use the last one be- 
cause it is located in my Documents folder, which is one of the locations of my filesystem 
that are automatically backed up. I also have shortcuts so that I can navigate there quickly. 
Below is what the Python scripting console looks for me at this point: (1) the two lines of 
Python code I have typed in, and (2) the response from the interpreter (Figure 13.14.3.12): 


eee KiPython 


*Shell* 


Py 0.9.8 

Python 3.8.2 (v3.8.2:7b3ab5921f, Feb 24 2020, 17:52:18) 

[Clang 6.0 Cclang-600.0.57)] on darwin 

Type "help", "copyright", "credits" or "license" for more information, 

Startup script executed: /Users/peter/Library/Pre: es/kicad/5.99/PyShell_pcbnew_startup.py 


>>> import pcbnew 
print(peb P 
pplications/KiCad/KiCad .app/Contents/SharedSupport/scripting 
/Applications/KiCad/KiCad .app/Contents/SharedSupport/scripting/plugins 
/Users/peter/Library/Preferences/kicad/5.99/scripting 
/Users/peter/Library/Preferences/kicad/S.99/scripting/plugins 


/Users/peter/Documents/KiCad/5.99/scripting 
/Users/peter/Documents/KiCad/5.99/scripting/pl 


Namespace Display Calltip History Dispatcher 
locals() 


Type: <class ‘dict'> 


Value: ([*__name__': ' main’, *__doc....': None, *'._pockage,_*: 
None, '.__loader__': None, '__spec__': None, '__builtins__*': module 
‘builtins’ (built-in)>, *shell': <wx.py.shell.ShellFacade object 

at Ox7ffe@8bdcbb@>, 'f': <_io.TextIOWrapper name= 
*/fUsers/peter/Library/Preferences/kicad/5.99/PyShell_pcbnew_startup. 
py" mode='r' encoding='US-ASCIT*>, ‘notebook’; «<wx,_core.Notebook 
object at Ox7ffe@8be24cO>, ‘filling’: <wx.py.filling.Filling object 
at @x7ffe@8be23a0>, 'pp': <bound method Display.setItem of <wx.py. 
crust. Display object at @x7ffe@8be2af0>>, 'pcbnew': «module 

"pcbnew’ from 

'/Applications/KiCad/KiCad. app/Contents/Frameworks/Python. framework/ 


Kicad Python 
Figure 13.14.3.12: The Python scripting console helps me 
find the folders where I can store KiCad plugins. 


If you are wondering why the path of my KiCad instance plugin folders contains the version 
"5.99", it is because at the time I am writing this book, I am using the KiCad version 5.99 
nightly builds. 

There is a shortcut for the KiCad plugins directory. Click on Tools —> External Plugins —> 
Reveal Plugin Folder, and KiCad will take you straight there. 

It is OK to close the Python scripting console. Now that we know where to store the plugin 
let's focus on the plugin itself. In the plugin's Github repository, click on the "Download ZIP" 
link (under the green "Code" button) to download it (Figure 13.14.3.13). 
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O £ s github.com/openscopeproject/interactiveHtmifom 


©) openscopeprojectlnteractócs HimiBam: Interactive HTML BOM generation plugin for KiCad (O installation + openscopaprojel 


Pullrequests Issues Marketplace Explore 


E openscopeproject / InteractiveHtmiBom O Watch + 87 


<> Code Issues 20 Pull requests 3 Actions Wiki Security L Insights 


F master ~  Ptbranch Q10 tags Go to file Add file ~ Al 


In 
KÈ) quick ignore visibility on PTEXT (kicad) == BJ Cione © pl 
HTTPS SSH GitHub CU 
j Y 
h visi P a z 
Da InteractiveHtmiBom ignore visibility on PTEXT (kicac https: //qithub.con/openstopeptosecut 0 
DA icons Switch to using bitmaps in smal Use Git or checkout with SVN using the web URL 
ji a 
.gitignore Use wxformbuilder 3.9.0 
CH Open with GitHub Desktop ae 


jsbeautifyre Add jsbeautifre and autoforma 
DATAFORMAT.md Revert removed description of (E) Downl: P 
Re 


Figure 13.14.3.13: Download the ZIP archive of the plugin. 


Download the archive and expand it. Then navigate to the plugin folder that you chose, and 
copy the plugin folder in it. For my setup, it looks like this (Figure 13.14.3.14): 


eee < plugins : By Ov ~ ê~ >» Q 


il 
o 


plugins MCU Dataloggor 4 
Name 


~ DD InteractiveHtmiBom 
A init py 
DATAFORMAT.md 
> © icons 
> EJ InteractiveHtmiBom 
LICENSE Tod 
README.md i 
settings_dialog.fbp Today at 1 


14KB Document 


Figure 13.14.3.14: The "Interactive HTML BOM"plugin folder 
copied in the KiCad plugins folder. 


Before you can use the new plugin, you must refresh the KiCad plugin's register. Go to Tools 
—> External Plugins, and click on Refresh Plugins (Figure 13.14.3.15): 
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Route Inspect Tools Preferences Help Window 


7] Update PCB from Schematic... 
ra LL 
Ld Q Q ( + Switch to Schematic Editor 


use netclass sizes 


Ed Footprint Editor 
7 yate Fo 


Wee Plugins 


Figure 13.14.3.15: Click on "Refresh Plugins" to activate new plugins. 


After about a second, a new icon will appear in the top toolbar (Figure 13.14.3.16): 


MCU Datalogger — PCB Editor 


Ml F.cu (PgUp) 


Figure 13.14.3.16: The new button 
Let's try this out. Click on the green HTML BOM button on the top toolbar to get to the pl- 


ugin's BOM generator window. Below I show how I have set up my BOM generator's three 
tabs (Figure 13.14.3.17). 
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interactiveHtmiliom v2.3 


General Hired hetmaite Citra faide 


Bom decoration 


Drectary [Usars/pater/DocumuntsKend\Cour 


Name format toon 


Adele pcb ate 


interactiveHtextiiom v2.3 


Cereal Himi detaune Ertra fialds 


Dark mode 


© Show footprint pacts 


Show fabricaten layer 
Show sikscreen 
Highight first pin 


interactiveHteniBom v2.3 


Gereral Htmi defaults Extra falda 
Netist t ard he 


/UsereneterDocumanteKicas\Course Gevsicomen — ... 


Enr tade 


MANUFACTURER t 


Z Pur 


Inchude trackajzonas 


DNP fiati norne 
‘Globe are aupporind, 0.9. MH* 
Blackhat virtusi componeres 


Blackbst components with empty value 


‘Companants with this fold not empty will 2° ignored 


<none> 


Save current settings 


‘Generate HOW Cancel Save current settings Generate BOM Cancel Surve currant settings 


Figure 13.14.3.17: The three tabs of the HTML BOM plugin. 


In the General tab, you can set the destination of the BOM files that this plugin will gener- 
ate. You can also set the ordering of the components based on their type (such as capaci- 
tors, resistors, etc.) 

In the Html defaults tab, you can control various visual elements that affect how the BOM 
HTML page will look in your browser. 

In the Extra fields tab, you can enable or disable the extra (custom) fields that you'd like 
to including the BOM export. 

Feel free to explore these options. Anything you set will only affect the BOM export, not 
your KiCad project. 

When you are ready, click on "Generate BOM." The plugin will generate several HTML and 
supporting files and invoke your default web browser to display the BOM. Mine looks like 
this (Figure 13.14.3.18): 
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Figure 13.14.3.18: The HTML BOM in the browser. 


As you move your mouse over various elements of the BOM page, you will notice that the 
page reacts. For example, try hovering the mouse pointer over one of the rows in the BOM 
table (on the left side of the page). The row is highlighted, and the corresponding footprint 
is also highlighted on the PCB rendering on the right side of the page. 

Notice that the BOM table contains columns for each field you selected in the configuration 
window. 

You can use the layout controls at the top-right of the page to change the configuration of 
the page, get a statistics summary of the board, export a board image, and switch between 
the front, back, or both sides of the PCB. 

To export the BOM so that you can process it in a spreadsheet, click on the copy button 
located on the top right side of the page(Figure 13.14.3.18): 


logger/bomfibom.html w os. nh @OBeee=z 
SE Bea A- - 2 
Copy to 
clipboard > iy 
Footprint 


C_0805_2012Metric 
C_0805_2012Metric 


R_0805_2012Metric 


R_0805_2012Metric 
R_0805_2012Metric 


LED LED_0805_2012Metric 
Figure 13.14.3.18: Copy the BOM data to the clipboard 
so you can paste it into a spreadsheet or text editor. 
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You can then copy the BOM to a spreadsheet, as you did with the previous two methods 
(Figure 13.14.3.19): 


lilt MCUcatarogneoon.. m. un © wawd o 


Insert Draw  PageLayout Formulas Data Review 
5 f 


null Sourced Placed References Purpose Value Footprint 
c4, (5 0.1uF C_O805_201%Metric 3 
, 3 22pF C_0885_2012Metric 2 
, R2, RG 10K R_0805_2012Metric 3 
R4 4.7K R_0805_2012Metric 2 
» R7 330 R_0805_2012Metric 2 
D2 LED LED_0805_2012Metric 2 


ATMEGA328P-AU OFPEDP9OBXIOOX120-32N 1 
, U3 241C1025 SOIC-8_5.23x5.23ma_P1.27mm 2 
DS13375+ SOIC127P600X175-8N 1 
Yi 32.768 KHz Crystal_SMD_5032-2P4n_5.0x3.2mm_| 
Y 16 MHz Crystal_S5MD_5032-2Pin_5.0x3, 2mm_Hand: 
Hi, H2, H3, Ha MountingHole MountingHole_2.1nm 
Battery PinHeader_1x82_P2.54mm_ Vertical 1 
GPIO Conn_@1x09_Male PinHeader_1x09_P2.54mm_W 
I2C Conn_01x04_Male PinHeader_1x04_P2.54am_Ver 
ICSP Conn_@2x03_Odd_Even PinHeader_2x03_P2.54: 1 
33 Serial UART Conn_01x04_Male PinHeader_1x84_P2. 18 


Figure 13.14.3.19: The HTML BOM data in a text editor and spreadsheet. 


LED_0805_21 
ATMEGA328 OFP8DP300X 
241C10258 SOIA 5.2% 
DS13375+  SONCI27P60% 
32.768 KHe Crystal SMD 
16MHz Crystal SMD 
MountingHal Mounting Hol 
Battery — PinMeader_1 
Conn_01:09_ PinHesder_1 
Conn_01:04_ PinMeader_1 
Conn_02:03_ PinHeador_2 
B Serial UART Conn 01x04, PinHeader 1 


SaGEGE SS oeupuaa wn 


In summary, to export a Bill of Materials of your PCB project, you can use three methods. 
The first two are available in KiCad "out of the box, "while the third method requires in- 
stalling a third-party plugin. The last two methods (the Edit Symbol Fields in Eeschema, 
and the Interactive HTML BOM plugin in Pcbnew) are equivalent in their ability to export 
custom fields. The last method, the Interactive HTML BOM plugin, is most suitable if you 
wish to publish complete BOM documentation on a website that includes full component 
information and renderings of the front and back of the PCB. 


13.15. Import components from Snapeda 

In this chapter, you will learn how to import symbols, footprints, and 3D models (3D shapes) 
in KiCad from Snapeda.com. To demonstrate the process, I have set up a new KiCad pro- 
ject. In this project, I want to use a component that does not exist in the KiCad libraries: 
the Texas Instruments MSC1212Y5PAGT central processing unit. 

Snapeda is an online repository of electronics CAD components. In my day-to-day work 
with KiCad, I turn to Snapeda to look for symbols, footprints, and 3D shapes every time 
I need one that does not exist in the libraries that come with KiCad. Often, I also look at 
Snapeda for better versions of components that already exist in KiCad. Because it is such 
a helpful resource, I decided having a dedicated Recipe chapter in this book is worth it. 

If you wish to follow along, go to https://www.snapeda.com and create a new free account, 
or log in to your account if you already have one. Below is the homepage of snapeda.com 
(Figure 13.15.1): 


e 243 


KiCad Like a Pro, Projects, Tips and Recipes 


WSrapEDA About For Engineers vi For Part Vendors v Login | | simwa | 


Design electronics in a snap. 


Download free symbols, footprints, & 3D models for millions of electronic components 


Drste examples USB Type € saz Busto Module 


Trusted by over 1 million engineers at these companies & more 


Figure 13.15.1: The Snapeda homepage. 


Once you have logged in to Snapeda, use the search bar at the top of the page to search for 
the component you need. You can search with the model number, like "MSC1212Y5PAGT" 
or a keyword such as "Texas Instruments 8051 CPU". Snapeda will give you a list of hits. 
Select the one that matches your requirements by clicking on it. In my case, I will be work- 
ing with this component?® (Figure 13.15.1): 


o 
eee O < ... © s waw. snapeda.com/partaMSC12 127 SFAST/ Texas 20rmtrmentajvie: ®© + & 
WSreapEDA BrowseParns Q&A Q Search InstaBuild instaat MY FP A B futureshocked 
20 Medel 3DModel $ Buy on TLeom © Created by Snapt Da © 
% INSTRUMENTS 
SD Symbol © Footprint © 
MSC1212YSPAGT 
rc 
= m 
Get this part 
United produenon quantities 
| M Add to Library 
D See Datasheet PDF Relevant part wrth 7D modets 


Figure 13.15.1: The TI MSC1212Y5PAGT CPU component. 


18 MSC1212Y5PAGT 
8051 CPU with 32kB Memory, 24-Bit ADC, and Quad 16-Bit DACs 64-TQFP -40 to 125 


https://www.snapeda.com/parts/MSC1212Y5PAGT/Texas%20Instruments/view-part/41461/ 
?ref=search&t=MSC1212Y5PAGT 
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The component page contains two main tabs: 2D model (1) and 3D model (4). Under the 
2D Model tab you will find the Symbol (2) and the footprint (3). To see the 3D model, click 
on the 3D Model tab. It looks like this (Figure 13.15.2): 


ES 
WSnapEDA — erowseraris Q&A Q Search InstaBuild msaa EY P O [E nturesnocies 
20 Model 3D Model ® Buy on Ti.com O Created by SnapEDA € 
TEXAS 
MD 
ed 3D Model 


MSC1212Y5PAGT 


8051 CPU with 32kB Memory, 24-Bit 
ADC, and Quad 16-Bit DACs 64-TQFP 


4010 125 
'ackoge Type: TOFP-44 
AD Models: Symbol, Footprint. 30 Model 
Get this part @ Fullscreen 
Unlimited production quantities 


Buy on Ti.com 


Ji 
A AddtoLibrary g \ Q 
L f E 


Figure 13.15.2: The 3D model of the component in question. 


Available" column will indicate whether the 3D model and other parts of the component are 
available. In the example in Figure 13.15.3 (below), notice the icons under "Data Availa- 
ble": 


Manufacturer Image Part Package Availability Avg Price sso Description Data Available 
8059 CPU with 32KB 
Memory, 24-Bit : 
Pion MSC1212YSPAGT TOFP-64 o 36452 ADC, and Quad 16 44 Buy on The n>Ei0 nl 
Bit DACs 64-TQFP 
4010 125 
=> 805 CPU with 32k8 Memory, 24-Bit y ee 
Vien > MSC1212Y5PAGTGA  TQFP-64 o N/A ADC, and Quad 16-Bit DACs 64-TOFP 40 MEA 
to 125 


Figure 13.15.3: The available data for the search results. 


A solid-colored icon indicates that data is available. From left to right: 
e Datasheet. 
e Symbol. 
e Footprint. 

3D model. 

Simulator model. 

Sample. 
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The MSC1212Y5PAGT CPU component that I use in this example provides the datasheet, 
symbol, footprint, and 3D model. 

Let's download the symbol, footprint, and 3D model. Click on the 2D Model tab. Then, click 
on the "Download Symbol and Footprint" button. Snapeda will ask you to select the CAD 
software you will be using, so click on "KiCad." As you probably expect, this will download 
the symbol and the footprint, but it will also download the 3D model. Snapeda will archive 
these files in a single ZIP file. Extract them from the ZIP file (Figure 13.15.4). 


Name Date Modified Size Kind 


MSC1212Y5PAGT 

D how-to-import. htm 
MSC1212Y5PAGT.lib 
MSC1212Y5PAGT.step 
QFP50P1200X1200X120-64N.kicad_mod 

MSC1212Y5PAGT.STEP 


Figure 13.15.4: The symbol, footprint, and 3D model files. 


The folder I extracted from the ZIP file contains: 
e Symbol file, with the ".lib" extension. 
e Footprint file, with the ".kicad_mod" extension. 
e 3D model file, with the ".step" extension. 


Now that you have these files on your computer import them into KiCad. You can learn how 
to do this in earlier chapters in this book. See here for symbols, here for footprints, and 
here for 3D shapes. 

I have imported the files to my instance of KiCad, and I'll go ahead to use them. I'll start 
with the symbol. In my schematic editor, I type the "A" hotkey to add a new symbol. This 
brings up the Symbol Chooser. I type a few of the first letters for the new component to 
locate it in the library quickly. The Chooser promptly finds the symbol. Click on it to select 
it and show its preview in the right-side pane (Figure 13.15.5): 
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o o Choose Symbol (18086 items loaded) 
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MSC1212Y5PAGT 


Reference U? 
Footprint OFPSOP1200X1200X120-64N 
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Select with Browser Place repeated copies Place all units @ Cancel 


Figure 13.15.5: The new symbol. 


Double-click on the symbol to add it to the schematic editor (Figure 13.15.6): 
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Figure 13.15.6: The new symbol in the editor. 
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Once the new symbol is in your schematic editor, you can use it as you would with any other 
symbol. Let's continue with the footprint for the same component. I assume that you have 
already imported the footprint to KiCad. 

Double-click on the symbol to open up the symbol properties window. It looks like this 
(Figure 13.15.7): 


ece Symbol Properties 


General Alternate Pin Assignments 


Name Value HAlgn = VAlign Malic Bold Textsize 


Show 
Reference U? Center Center 127 


Value MSO1212Y5PAGT Center Center 127 
Footprint [OFPS0P1200X1200X120-54N. oi Left Bottom 127 
Datashest Left Bottom 127 
Purpose Rh Center Center 127 


+57 b+ Be 


E ony Update Symbol from Library... 
Show pin numbers 
Show pin names Change Symbol... 
Edit Symbol... 


Attributes 
Angie: O 8 
Mirror: Not mirrored e Exclude from bill of materiais 


Exclude from i Edit Library Symbol... 


Library link: MSC1212YSPAGT:MSC1212Y5PAGT Spice Model... Carcel E 


Figure 13.15.7: The new component symbol properties window. 


The "Footprint" field contains a default footprint that exists in the KiCad footprints library, 
the QFP50. I prefer to use the one that I downloaded from Snapeda, so click on the library 
button (marked by the arrow in the screenshot above). This will bring up the library foot- 
print chooser, which you can see below (Figure 13.15.8): 


nane ne ... Footprints — /Users/peterDocumenta)Kicad/Course development documents/WiCad 6 test proects/Blark Project Z/Lierariet/Footan 
m Reference U? BB CAQAQAA REG oazo mamon 8 
a 3 
PACE TIONI: ~ 
Foswert Om 20-64 ® Converter ACOC GFP5 120-64N 
Ê Converter 


O zomat 


angie 9 
Not mbrared 


QFP50P1200X1] 


22m xasm y ator 4220004 ty anane see 10008 


Figure 13.15.8: The new footprint library. 
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I imported the new footprint using the name "Footprints" as the library name. For this rea- 
son, the footprints chooser window shows the footprint file under "Footprints". You should 
adjust your search by taking into account the name of the new footprint library that you 
used during the import process. 

Double-click on the footprint to complete the association. The footprint chooser window will 
close, and you will be back at the symbol properties window (Figure 13.15.8). 


eee Symbol Properties 


General Alternate Pin Assignments 


H Align V Align italic Bold Text Size 


Center Center 1,27 

Center Center 1,27 

Left Bottom 1,27 

Left Bottom 127 

Purpose Center Cemer 1.27 
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“e 
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Gi i Pin Ti 
neral in Tons Update Symbol from Library. 


Show pin numbers 


Shes rr Change Symbol. 


Edit Symbol 
Attributes 
Angle: o 8 
i 7 Exclude from bill of materiais 
Mirror: Not mirrored 8 Edit Library Symbol. 
Exclude from board 
Library link: MSC1212YSPAGT:MSC1212Y5PAGT Spice Model, caca =|, CD 


Figure 13.15.8: The new footprint and symbols are now associated. 


I have now associated the new symbol with its matching footprint. In the screenshot above, 
notice how the associated footprint belongs to the "Footprints" library. 

Next: let's make use of the new 3D shape. To do that, open Pcbnew, update the layout 
editor with the schematic data, and draw a rectangle graphic around the only footprint in 
the Edge.cuts layer (Figure 13.15.9). 


MSC1212Y3PAGT 


Figure 13.15.9: The new footprint in Pcbnew with an Edge.cuts graphic. 
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I will set a 3D shape for the new footprint. Double-click on the footprint, and click on the 
3D Models tab. By default, this footprint does not have a 3D model defined, so there are no 


rows in the 3D Model(s) list (Figure 13.15.10). 


... Footprint Properties 


General Clearance Overrides and Settings 3D Models 


o. <> <> 62> > 


co. co. 


Library link: Footprints:QFP50P1200X1200X120-64N 


3D Model(s) Show 
r 
+ b v Contigure Paths... 
Preview $ 


Cancel 


Figure 13.15.10: The new footprint's 3D Models tab. 


To add a new 3D symbol, click on the "+" button to add a new row (Figure 13.15.11): 


o... Footprint Properties 


General Clearance Overrides and Settings 30 Models 


3D Models) Show 

+ ta 1] l Configure Paths... 
ln Preview 

X: 1.0000 =3 Y 

w 1nnan 


Figure 13.15.11: A new row to hold the path for the 3D model. 


Click on the folder button (right side of the new 3D model row). This will bring up a file 
browser to locate and select the 3D shape (".step") file. In my example, it looks like this 


(Figure 13.15.12): 
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Select a File 
zv By Ez Blank Project 2 

Name Date Mi 
> DD Blank Project 2-backups Today d 
E Blank Project 2.kicad_sch Today a 

fp-lib-table Today 
sym-lib-table Today 4 

v © Libraries Today 
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w EJ Footprints Today d 

QFP50P1200X1200X120-64N.kicad_mod Yester 

~ E] Symbols Today 
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JE Blank Project 2.kicad_pcb Today a 
CE Blank Project 2.kicad_pro 1 Jul 20 
Blank Project 2.kicad_pri 1 Jul 20 


Figure 13.15.12: Double-click on the 3D model ".step" file 
to add it to the footprint properties. 


Double-click on the ".step" file to add it to the footprint properties. The Preview pane will 
super-impose the model over the footprint, but it may be out of place at first. You will need 
to adjust some of the placement parameters (scale, rotation, and offset) to make the model 
align with the footprint. Below you can see my settings (I only changed the X rotation to 
-90°) (Figure 13.15.13): 


o o Footprint Properties 


General Clearance Overrides and Settings 30 Models 


30 Model(s) Show 
E O III 


+ b Š Configure Paths... 


Seale 


X: 1.0000 Y 


Y: 1.0000 

Zz: 1.0000 
Rotation 

X: -90.00 deg 
Y; 0.00 deg 
Z: 0.00 deg 


a 
{X 
a 
Y 
a 
Y 


Offset 

X: 0.0000 mm 
Y: 0.0000 mm 
Z: 0.0000 mm 


0 100 100 


Library link; Footprints:QFP50P1200X1200X120-64N Cancel OK 


Figure 13.15.13: With a bit of tweaking, the 3D model aligns with the footprint. 
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Click OK to dismiss the window. Back in Pcbnew, bring up the 3D Viewer from the View 
menu to see the new 3D model (Figure 13.15.14): 


Figure 13.15.14: The new 3D model as it appears in the 3D Viewer. 


Snapeda is an excellent source for symbols, footprints, and 3D shapes, but not the only 
one. I remind you that in previous chapters (see here and here) I have discussed others 
sources that you can consider when you are looking for components for your projects. 


13.16. The FreeRouting autorouter 

The routing process of a new PCB is often the most time-consuming one. Especially in PCBs 
with many pins and confined space, routing can be tedious and frustrating. I find that an 
autoroute can help in such cases. An autorouter is software that can automatically create 
tracks using various algorithms optimized for the minimization of the total track length or 
vias used. Most modern autorouters offer extensive customizability. 

Should you use an autorouter? 

Opinions differ, and appropriate use cases for autorouters vary. Autorouters tend to be 
"naive." While the designer may customize an autorouter to some extent, autorouters do 
not "understand" the specific peculiarities of the various circuit segments on which they 
operate. For example, an autoroute will not be able to "understand" the importance of the 
shape and length of a differential track that connects a high-speed CPU with a memory chip 
or the track that connects an RF component to an antenna. Autorouted boards also tend 
to look less refined, with tracks drawn in a mechanical way distinctively different to tracks 
drained by a skilled designer. 

Professional PCB designers tend to rely on manual routing for all but the most trivial PCBs. 
Often, autoroutes are used extensively during the prototyping process. The designer will 
often edit an autorouted board to improve it. 

With all that in mind, auto-routing is a tool that is worth knowing and used when appropri- 
ate and with care. This chapter will show you how to use an external auto-router that works 
well with KiCad 6, FreeRouting’’. 


19 https://freerouting.org 
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Below is an example of what an autoroute board looks like using FreeRouting (left side). 
The autorouted completed the operation in approximately 3 minutes. On the right side of 
the screenshot is the same board, routed by myself. It took me around 90 minutes to com- 
plete this work (Figure 13.16.1). 


ve Deora Lament 
Hon Dapa Pramene files Wnt Ohe Hey Bescon ®2QQRQQ 54 HAS SH Ble mor- 


ot ee Soy dai li ed ue 3 a 


= enus 


AMODAN bhosa f> 


RB 74. 


‘Trace Lovestr 1.864.778 4787 cano DEIS OTOH. EOS: 


Ponreraw owerragimt Vc Court: ai 


Figure 13.16.1: The same board routed automatically (left) and manually (right). 


"FreeRouting" is not only an autorouter. You can use it to manually route a board, similar 
to how you can use Pcbnew. 

Below is an example (Figure 13.16.2). I have deleted some of the autorouted tracks, ena- 
bled the Route functions, and used the mouse to draw a new route that connects the two 
pads. FreeRouting "knows" which pads and pins can be connected because I have imported 
a file that I generated earlier in KiCad (you will learn how to use FreeRouting with KiCad 
later in this chapter). 
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eee Board Layout 
File Display Parameter Rules Info Other Help 
Select torte Drag Autorouter Undo Redo trecomeletes | Woltony Zoom AJ | Zoom Region Uniti 4 - 8 


l routing net Net-IC2-Pad2) target layer: F.Cu current layer: F.Cu cursor: (119,392.898 , -90,414. 


Figure 13.16.2: FreeRouting is also useful as a manual router. 


FreeRouting is an open-source Java application that works with the KiCad, Eagle, and Lay- 
outEditor CAD packages. 

It works as a separate and distinct application; that is, it does not integrate with KiCad. It 
can exchange information with KiCad utilizing import and export files. It is a bit rough in the 
edges, as it can be challenging to learn and get used to its user interface. 

FreeRouting can automatically route a PCB in multiple layers, and it is very configurable. 
You can configure many aspects of the autoroutes operation, such as the preferred direc- 
tion of the traces on each layer, whether to use vias or not, and whether to do a post-route 
pass to try and reduce the number of vias or total trace length. 

In the following few segments in this chapter, I will show you how to install FreeRouting on 
MacOS, Linux Kubuntu, and Windows 10 and then use it to route a test board in two and 
four layers. FreeRouting, being a Java application, can potentially work on any operating 
system with the Java runtime environment installed. In practice, I have noticed problems 
that seem to be related to the application's graphical libraries. After trial and error, I have 
found that Kubuntu is a good choice for working with KiCad and FreeRouting on Linux, es- 
pecially compared to Ubuntu Linux. 


13.16.1. Install and start FreeRouting on MacOS 


In this segment, you will learn how to install FreeRouting on MacOS and start the applica- 
tion. Let's begin. 
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FreeRouting is a Java application, so you will need to install the Java runtime environment 
on your Mac. MacOS ships with the JRE, so there is a good chance that you don't need to do 
anything else at this point. You can find the JRE downloads page here: https://www.java. 
com/en/download/manual.jsp or https://jdk.java.net/16/. 


To confirm that your Mac is ready to run Java applications, bring up a terminal window and 
type this command: 


% java --version 


Below is the response that I see on my iMac, OpenJDK 16.0.1 (Figure 13.16.1.3): 


eee zsh XH1 


version 


OpenJDK Runtime Environment AdoptOpenJDK-16.0.14+9 (build 16.0 
1+9) 


OpenJDK 64-Bit Server VM AdoptOpenJDK-16.@.1+9 (build 16.0 
9, m mode, sharing) 


peter@reters Mac i 


Figure 13.16.1.3: The JRE version that is running on my iMac. 


With the JRE sorted, continue to Github to download the compiled version of the FreeR- 


outing application. The download page is at https://github.com/freerouting/freerouting/ 
releases (Figure 13.16.1.4). 


e 
ot O AAA 


DD paternos -trosrentingtrowesting Hm 


+ Added more details about KiCad support (see README, @andrasfuchs) 
Bugfixes 


e Fixed an endless loop (issue #15) 
+ Fixed a DSN file handling problem (issue #22) 
e Fixed many typos and compilation warnings 


(a) de 1 1 person reacted 


+ Assets 5 


@ freerouting-1.4.4-linux-x64.zip 

@ ffreerouting-1.4.4-macos-x64.dmg 
9 freerouting-1.4,4-windows-x64.msi 
[ Source code (zip) 


ff) Source code (tar.gz) 


Figure 13.16.1.4: The FreeRouting downloads page. 


At the time I am writing these lines, the latest available version of FreeRouting is 1.4.4. As 
you can see above, the project offers compiled versions for Linux, MacOS, and Windows. 
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Download the DMG file for MacOS, then double-click on it to mount the virtual disk in your 
Mac's file system (1) and click "Agree" (2) in the dialog box that appears (Figure 13.16.1.5). 


Downloads 


Folder shared with File Sharing 


z fraerouting-1.4.4-macos-x64,dmg — > 23 Jul 2021 at 12:57 pm 


ee freerouting-1,4,4-macos-x64.dmg 


If you agree with the terms of GNU GENERAL PUBLIC LICENSE 


this license, click "Agree” to Version 3, 29 June 2007 
access the software. If you 
do not agree, press Copyright (C) 2007 Free Software Foundation, inc. <hitp2/itst.org/> 
"Disagree." Everyone is P E ED aa verbatim copies 
of thés license document, but changing it is not 
Preamble 
TOR OU Senge aes EAA copytett 
software and other kinds of 


The licenses for most software and other practical works aro 


any other work released this way by its authors. You can apply It to 
your programs, too. 


When we speak of free software, wo aro referring to freedom, not 


Figure 13.16.1.5: Mount the FreeRouting virtual disk on the MacOS file system. 


The FreeRouting virtual disk is now mounted on your Mac's file system. Click on it (1), 
and you will see a single application file. Double-click on the application file (2) (Figure 
13.16.1.6): 


iil 


> 


eee < Freerouting 


Favourites Freérvúting 


Æt Freerouting 


> 
Figure 13.16.1.6: The FreeRouting application is inside the FreeRouting virtual disk. 
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Unfortunately, there seems to be a bug in the file that prevents the FreeRouting application 
from starting. You should see an error message like this (Figure 13.16.1.7): 


Á 


“Freerouting” is damaged and 
can't be opened. You should 
eject the disk image. 


Eject Disk Irpage 


Figure 13.16.1.7: No, FreeRouting is not damaged. Don't eject the disk! 


This message is misleading. FreeRouting is not damaged. However, its launcher seems to 
contain a bug that prevents the application from starting. Thankfully, this is something that 
we can quickly fix. 

Right-click on the application file to show the context menu, and click on "Show Package 
Contents" (Figure 13.16.1.8). 


Bn 


Open 


Show Package Contents 


Get Info 

Compress “Freerouting" 
Make Alias 

Quick Look 


Copy 
Share > 


Figure 13.16.1.8: The application package contains the actual FreeRouting application file. 
This will reveal the files contained within the package. You can browse these files. Go in 


the "Contents" and the "app" directories until you see the "freerouting-executable.jar" file 
(Figure 13.16.1.9). 
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< Freerouting =$ E- O~ ® » ê~ 


Freerouting 


ES Contento 
< D app 


D Froorouting ctg 
D nfo.piist 
> EJ MacOS 
Pieginto 
> EZ Resources 
> EZ runtime 


Figure 13.16.1.9: Drag "freerouting-executable.jar" in the Applications folder. 


The file with the ".jar" extension is the actual Java application. You can start the application 
at its present location. But, if you plan to use FreeRouting in the future, it is better to copy 
it into the Application directory. Drag and drop "freerouting-executable.jar" into the Appli- 
cations directory (Figure 13.16.1.10). 


e... < Applications = 
Favourites Freerouting 
® AlrDrop anes 
© Recent © FaceTime 
4 Applications © Find My 
@ Firafox 
al p W Font Book 
E Creative Cloud Files Rs FreeCAD 
Kicad => freeroutinyexecutable. jar 
@ Google Chrome 
5 Kicad 3 A GPG Keychain 


Figure 13.16.1.10: The FreeRouting application is in the Application directory. 


Because of MacOS security, the first time you attempt to start FreeRouting you will see a 


message like this (Figure 13.16.1.11): 


“freerouting-executable.jar” 
cannot be opened because it is 
from an unidentified developer. 


macOS cannot verify that this app is free 
from malware. 


Figure 13.16.1.11: FreeRouting is from an unidentified 
developer and MacOS will block it from starting. 
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You will need to permit MacOS to start FreeRouting. Click on the Apple menu (top left of 
the screen) and then click on System Preferences. In the Preferences window, select the 


"Security & Privacy" widget (1) (Figure 13.16.1.12). 


Show a message when the screen is locked 
Disable automatic login 
Use your Apple Watch to unlock apps and your Mac 


Allow apps downloaded from: 
App Store 
O App Store and identified developers 


from an identified developer. 


GB Click the lock to prevent further changes 


“fraerouting-executable.jar* was blocked from use because it is not 


ee < HH Security & Privacy Q securi 
— General FileVault Firewall Privacy 


A login password has been set for this user Change Password... 


Require password 5 minutes 8 after sleep or screen saver begins 


$ 


Open Anyway 


Advanced... 


? 


Figure 13.16.1.12: Allow FreeRouting to start in the Preferences, 


Security & Privacy dialog. 


In the Security & Privacy dialog box, click on General (2). Ensure that the padlock is open 
(3) and that "freerouting-executable.jar" is listed in the "Allow apps downloaded from:" 
segment. Then, click on "Open Anyway" (4). You'll see a confirmation window; click OK to 


dismiss it. 


After this process, FreeRouting will start (Figure 13.16.1.13): 


@  MainApplication 


£ ee Freerouter v1.4.4-SNAPSHOT (build-date: 2020-04-19) 


Open Your Own Design 


Neither '-de <design file>’ nor '-di <design directory>' are sp 


General FileVault 


Y Disable automatic login 


Firewall Privacy 


A login password has been set for this user Change Password... 
Y Require password 5 minutes © after sleep or screen saver begins 
Show a message when the screen is locked 


Y Use your Apple Watch to unlock apps and your Mac 


Figure 13.16.1.13: FreeRouting starts for the first time. 
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The FreeRouting window that appears contains a single button. When you click this button, 
you will see a file system browser that you can use to import a compatible file from KiCad. 
I'll show you how this works later in this chapter. 

An alternative way to start Freerouter is to use the command line. Bring up a terminal win- 
dow, and type this command: 


% java -jar /Applications/freerouting-executable.jar 


Below is a screenshot of my terminal (Figure 13.16.1.14): 


peterBPeters-iMac 6 ve ] Applications/freerouting-executable,j3ar 


021-09-01 10:06:26.984 [ n] INFO eu.mihosoft.freerouting.FreeRouting 


outing application is started. 


Open Your Own Design 


Neither '-de <design file>' nor '-di <design directory>' are sp 


Figure 13.16.1.14: Starting Freerouter via the command line. 


At this point, you have installed FreeRouting on MacOS, and started the application. To 
learn how to use it alongside KiCad and perform auto-routing, jump to the 2-layer exam- 
ple. If you want to learn how to install FreeRouting on Linux or Windows, continue reading. 


13.16.2. Install and start FreeRouting on Linux Kubuntu 

FreeRouting works well with Linux Kubuntu, as does KiCad 6. Perhaps this is because 
Kubuntu uses the KDE desktop*° which seems to be more compatible with the GUI elements 
of both KiCad and FreeRouting. Below you can see my Kubuntu desktop with the system 
information window (Figure 13.16.2.15): 


20 https://kde.org 
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System Information 
> 


D Kubuntu 21.04 


Freerouting SNAPSHOT Builds 


Figure 13.16.2.15: My Linux Kubuntu desktop. 


Kubuntu contains a suitable Java runtime environment so that you can proceed with the 


download of the Freerouting application. The download page is at https://github.com/ 
freerouting/freerouting/releases (Figure 13.16.2.16). 


©) Releases freeroutingitre x + 


é Cc 086 github.com 


+ Added command line arguments for scripting support (see README, @andrasfuchs) 
+ Added robust logging framework (log4), @andrasfuchs} 

+ JDK 11 compatibility (@miho) 

+ Automatic build system (@miho) 

» Added more details about KiCad support (see README, @andrastuchs) 


Bugfixes 


+ Fixed an endless loop (issue #15) 
+ Fixed a DSN file handling problem (issue 422) 
+ Fixed many typos and compilation warnings 


at 1 pera 
+ Assets 5 


@ freerouting-1.4.4-macos-x64.dmg 
@ treerouling-1.4.4-windows-x64.mai 
M) Source code (zip: 


M) Source code (tar.gz) 


Figure 13.16.2.16: Download the FreeRouting executable for Linux. 


Extract the contents of the ZIP file, and browse the files (Figure 13.16.2.17). 
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Archive file Settings Heip 


[E] tana Y E Preview PA opm Q find, [Ep an E 
~ Sue 


Name Compressed Mode CRC chee! 
v P] freervuting-14.4limucxó4 2 Folders, 1 Fe dra 
El bin 1 File dr wrx 

T Freerouting 216.7 KiB 74,7 KiB nwar- > IDADABAL 
~ PJ lib 2 Folders, 2 Files drwrt-xr-x 
v Pl opp 3 Files drwxr-xr-x 

MT Freerouting.cfg 3308 168.0 Meth  AQQQSAEE 


freerouting-1,444m0x64,z1p (Zip 


11,9 KiB C1445057} 


Ner 


ES 

> P) cont 1 Folder. 2 Fates Anwar 

> E] legal 5 Folders drwxr-xr-x 

> E iib 3 Folders, 28 Files drwat-ar-x 
IT) release 938 788 nert-  BAAFTGBÁ 
EZ Freerouting.png 48%8 4.88 -ver-r  BCZFGOBI 
Q, libapplauncherso 1.5 MB 475.7 iB ni-i- D64IA772 
[F] LICENSE 345 KiB 11.9 KiB Iwer=1-  C1445D67 


Figure 13.16.2.17: The contents of the FreeRouting ZIP archive. 


The only file that you need from the archive is the one with the ".jar" extension, under "fre- 
erouting-1.4.4-linux-x64", "bin," "lib," "app." You can copy this file at a convenient location 
on your Linux file system. 1 copied my instance on the desktop (Figure 13.16.2.18). 


ME Greadoardi = A Om O= 


PXEGOTO O! 


Place 
fa) Home | ii te 
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EZ] Pictures 
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Remote 


Network 


Recent 


Figure 13.16.2.18: The FreeRouting executable on my Kubuntu desktop. 


To start FreeRouting, you must use this command line instruction (I assume that your 
FreeRouting executable is on the desktop) (Figure 13.16.2.19): 
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$ java -jar ~/Desktop/freerouting-executable. jar 


=: bash — Konsole 


File Edit View Bookmarks Settings Help 


$ java -jar ~/Desktop/freerouting-executable. jar 


Figure 13.16.2.19: Starting FreeRouting on the Kubuntu command line. 


This will start the application. You should see the FreeRouting window, like this (Figure 
13.16.2.20): 


s Settings Help 


Figure 13.16.2.20: FreeRouting has started and waiting for an import file from KiCad. 


At this point, you have installed FreeRouting on Linux Kubuntu and started the application. 
To learn how to use it alongside KiCad and perform auto-routing, jump to the 2-layer ex- 
ample. 


13.16.3. Install and start FreeRouting on Windows 

In this segment, you will learn how to install FreeRouting in Windows 10. The process is 
simpler than in Linux or MacOS. The download page is at https: //github.com/freerouting/ 
freerouting/releases (Figure 13.16.3.21). 
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M Source code (zip) 
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O SNAPSHOT 
EPA @ miho released this Mar 23, 2020 
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Figure 13.16.3.21: Download the FreeRouting executable for Linux. 


Click on the Windows ".msi" archive to download it. Double-click on the ".msi" file to start 
the installation process (Figure 13.16.3.22): 


PC > Downloads > Downloads v & Search Downloads 


El | 8 Freerouting Setup 


Name 


freerouting-1.4.4-macos-x64,dmg 
P treerouting-1.4.4-windows-x64 


GNU GENERAL PUBLIC LICENSE A 
'ersion 3, 29 June 2007 


Copyright (C) 2007 Free Software 
Foundation, Inc. <http./Msf org/> Everyone 
is permitted to copy and distribute 

im copies of this license document, 
but changing it is not allowed. 


Preamble 
The GNU General Public License is a ad 


[Al accept the terms in the License Agreement 


Print me | inst | | Cancel 


Figure 13.16.3.22: The Windows installer for FreeRouting. 


The installation process includes only a couple of steps (Figure 13.16.3.23): 
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49 Freerouting Setup 


Installing Freerouting 


Please walt while the Setup Wizard mstals Freerouting. 


Status: Creatina shortcuts 
o 


F Freerouting Setup 


Completed the Freerouting Setup 
Wizard 


Cick the Finish button to exit the Setup Wizard. 


Figure 13.16.3.23: The installation process has two steps. 


Click "Finish" (see above) to complete the installation. That is. 

Your instance of the FreeRouting application is now installed. Start the application by click- 
ing on the Windows search box (bottom left of the screen) and type "freerouting" (1). 
Windows will find the application. It may need a few seconds as the Windows search 
index is working in the background. Double-click on the application to start it (2) (Figure 


13.16.3.24). 


J æ Freerouting 


K ® freerouting-1.4.2-windows-x64.msi 


my Store 
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Uninstall 


a 
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Figure 13.16.3.24: The FreeRouting application is ready to use. 


The application will start and wait for you to indicate the import file to open (Figure 


13.16.3.25): 
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Figure 13.16.3.25: The FreeRouting application has started. 


At this point, you have installed FreeRouting on Windows 10 and started the application. 
To learn how to use it alongside KiCad and perform auto-routing, continue with the 2-layer 
example in the next segment of this chapter. 


13.16.4. How to use the FreeRouting autorouter 2-layer example 

You now have FreeRouting installed on your computer. It is time to use it. In this segment 
of the chapter, you will learn how to route a 2-layer PCB automatically. For this demon- 
stration, I will use the layout from one of the projects you completed earlier in this book. 
Below is the example PCB that I routed manually (the MCU cataloguer). 


8 GND VCC - aDo RX TX 


Figure 13.16.4.26: This PCB is routed manually in Pcbnew. 


The PCB in the screenshot above is a 2-layer board, and you can confirm by looking at the 
number of copper layers in Board Setup —> Physical Stackup (Figure 13.16.4.27): 
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Board thickness from stackup: 1.6 mm 
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Export to Clipboard 


Figure 13.16.4.27: This is a 2-layer PCB. 


I will remove all zones, traces and vias by using Pcbnew's Global Deletions tool (Edit —> 


Global Deletions): 


e Delete Items 
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Current layer: F.Cu 


Figure 13.16.4.28: Delete all zones, tracks, and vias. 


Filter Settings 
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Vias 


Layer Filter 
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Current layer only 


I now have a PCB without routes, ready to be automatically routed. 
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Figure 13.16.4.29: This PCB has no routes. 


KiCad can work with FreeRouting using a Specctra DSN” file. Export the DSN file from the 
File menu: File —> Export —> Specctra DSN...: 
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Figure 13.16.4.30: Export the DSN file. 


KiCad will ask you for a location for the new file. I choose to save it in the project folder: 


21 https://en.wikipedia.org/wiki/Specctra 
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fp-info-cache byt Document 
fp-lib-table 1 t Docum: 
Libraries 


MCU Datalogger-backups H 


BB MCU Datalogger.dsn 

155] MCU Datalogger.kicad_pcb h 
MCU Datalogger.kicad_pri KB Document 

[9 mcu Dataloager.kicad_pro 10KB kicad project fil 


Figure 13.16.4.31: The new DSN file. 


It is time to import the DSN file in FreeRouting. Start FreeRouting if not already running 
(see below), and click on the button "Open Your Own Design" (1). Navigate to the location 
where you saved the DSN file, select it (2), and click Open (3). 


@ = MainApplication 


ATAQQAAL 


Via: use netelass sizes $ Grid: 0.1270 men (0.0050 in) 


Open Your Own Desig 


Neither '-de <design file>" nor '-di <design directory>' are sp 


T MCU Datalogger 


MCU Pope! peces Monday, 26 July 2021, 9:22 am 


K 
a 
E 
+ 


+ 


Jayer_WCU_Datalogger_Gerbees 

77 4 _Jayer_MCU_Datalogger_Gerbers 

E connectors.kicad_ach 
tp-Into-cacho 


TZ 4 Jayer_MCU_Datalogger_Gerbers 
E 2_layer_MCU_Datalogger_Gerbers 


E Ubraries 


Thursday, 22 July 2021, 1:36 pm 
Thursday, 22 July 2021, 11:16 am 


Wednesday, 21 July 2021, 8:59 am 
File Format: files with the extensions... El 


Cancel Open 


Figure 13.16.4.32: Import the DSN file to FreeRouting. 


Freerouter's Board Layout window will appear with the PCB and ratsnest lines indicating the 


required tracks (Figure 13.16.4.33): 
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9 Board Layout 
File Display Parameter Rules “nfo Other Help 
Select Route Drag Autorouter ‘Undo | Redo incompletes | Violations Zoom Ali | Zoom Region Unit: 1 „a 
79 incomplete connections to route current layer: F.Cu cursor: (0,0) 


Figure 13.16.4.33: The unrolled PCB in FreeRouting. 


If this is the first time you are using Freerouter, take a few minutes to click around the 
various menus and become familiar with the interface. There are helpful options under the 
Help menu, including a full eBook (Help —> Help Contents). Notice the three buttons at the 
top-left corner of the window: Select, Route, Drag. You can experiment with manual routing 
by clicking on the Route button and then click on a pad to start drawing, move the mouse 
to draw the route, and click again to finish the drawing. You can move footprints or tracks 
by clicking on the Drag button. With the Select button, you can select a board item, such 
as a pad, and act on it using one of the available commands that appear on the menu bar. 
To delete multiple tracks, click on the "Select" button and create a rectangle that contains 
the routes you want to delete with your mouse. Then, hit the Delete key on the keyboard 
to delete the selected tracks. You can delete an individual trace by clicking to select it and 
then hit the Delete key. 

To start the autorouter with its default settings, click on the Autorouter button (Figure 
13.16.4.34). 
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o Board Layout 
File Display Parameter Rules Info Other Help 


Select Route Drag Autorouter Undo | Redo incompletes | Violations Zoom All | Zoom Region Unit: 1 -B 


Figure 13.16.4.34: Start the autorouter by clicking on the Autorouter button. 


The autorouter will get to work immediately and report its progress in the status bar at the 
bottom of the window. To stop the autorouter, click anywhere inside the window. 

To customize the auto-routing algorithm, use the various options inside the Parameter and 
Rules menus. For example, click on Parameter —> Autoroute to bring up the Autoroute 
Parameter dialog (Figure 13.16.4.35): 


File Display Parameter Rules Info Other Help 
Select Route Drag Autorouter Undo Redo incompletes Violations Zoom All | Zoom Region Unit: 1 “> 


Layer Active: Preferred Direction: 
horizontal > 


vertical > 


Y Autoroute 
v Postroute 
Detail parameter 
13 Detal! Autoroute Parameter 
Via costs: 
Powerplane via costs. 
Start pass: 


Ripup start costs. 


Trace costs on layer: In preferred direction: Against preferred direction: 


F.Cu 1.0 2,5 
B,Cu 10 17 


(note: you need to press Enter to apply the new values) 


Figure 13.16.4.35: The Autorouter Parameter dialog box. 
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The Autoroute Parameter dialog allows you to choose the preferred direction of drawing for 
the enabled layers and configure the pass mode. Click on the Detail Parameter button to 
reveal a secondary dialog box with further options. 

Another example of a way to fine-tune the autorouter algorithm with the Net Classes dialog 
box (Rule —> Net Classes): 


File Display Parameter Rules Info Other Help 
Select Route Drag Autorouter Undo Redo incompletes Violations Zoom All | Zoom Region Unit: 1 


Net Classes 


via rule clearance class trace width on layer shove fixed cycles with areas min, length 
default default 250.0 all 

kicad_default — kicad default 250.0 all 

Power Power 350.0 al 


Add Remove Assign Select Show Nets Filter Incompletes 


Figure 13.16.4.36: The Net Classes dialog box. 


In the Net Classes dialog box, you can see the net classes as I set them in the KiCad pro- 
ject, imported into Freerouter. You can configure individual properties for each, such as 
whether tracks that belong to a net class are allowed to shove another track. 

It is worth taking a bit of time to experiment with the various options and menus. 

Let's continue with the auto-routing and, this time, take it to completion. Click on the Au- 
torouter button, and allow enough time for the routing to complete. 

While the autorouter is working, you will see new routes appearing and others disappearing 
and replaced with optimized ones. Also, notice the progress figures in the status bar. In the 
screenshot below, the autorouter is in its second pass (1), with 73 incomplete routes (2) 
and 31 complete routes (3): 


| Batch Autorouter running, press left button to stop Pass 2 to route: 73, routed: 31, nipped: 4, failed: 0 cursor (100-903, -68.6147) | 
ee 


Figure 13.16.4.37: Autorouter progress showing incomplete routes. 


A few seconds later, I took another screenshot showing that all routes were complete after 
13 passes (1), using 23 vias (2) and with a total trace length of 888.17 mm): 


h Batch Optimizer running, press left button to stop Pai 13: Via Count: 23 Trace Length: 888.1706 cursor; (100.903 , 66.6147) 
A a Bn Dd A A A A 


Figure 13.16.4.38: Autorouter progress showing NO incomplete routes. 
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At this point, the autorouter will continue its work, optimizing the routing by reducing the 
total trace length and number of vias. You can stop it at any time by clicking inside the 
router window. 
With the PCB now fully routed, you can export the Specctra Session File so that you can 


continue the process in KiCad. Go to File, then click on Export Specctra Session File: 


Display Parameter Rules Info Other Help 


Save 
Save and Exit 
Cancel and Exit 
Save as 


ter Undo Redo incompletes Violations ZoomAll Zoom Region Unit: 


Start recording actions 
Replay recorded actions 
Save GUI Settings as Default 


Figure 13.16.4.39: Export Specctra Session File. 


The new file will have the ".ses" extension and is automatically saved in the location of the 


DSN file: 
eee < MCU Datalogger =S æ., Or »Q 
Name d 
> FT 2_layer_MCU_Datalogger_Gerbers Folder 
> D 4_layer_MCU_Datalogger_Gerbers Folder 
ZE connectors.kicad_sch 9KB  eesche...ocument 
fp-info-cache 2bytes Document 
fp-lib-table 120 bytes Document 
> © Libraries Folder 
> DD) MCU Datalogger-backups Folder 
MCU Datalogger.dsn 45KB Document 
Ø MCU Datalogger.kicad_pcb 240KB pcbnew board 
MCU Datalogger.kicad_prl 1KB Document 
Ki] MCU Datalogger.kicad_pro KB kicad project files 
& MCU Datalogger.kicad_sch 94KB eesche...ocument 
B MCU Datalogger.ses oc 
3 Rh 35KB XML 
sym-lib-table 260 bytes Document 


Figure 13.16.4.40: The ".ses” file in my project directory. 


Time to import the ".ses" file into Pcbnew. Go to Pcbnew and click on File —> Import —> 
Specctra Session... : 
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EN save copy xs 


File fo Other Help 


Selec Busen Undo Redo — iscompletes | Violations Zoom A Zoom Region 


| £3 Import e: a ras 
| à buon 


The imported will ask you for the location of the file. Find the file, select it, and click "Open" 
(Figure 13.16.4.42). 


a "MCU Datalogger — PCB Editor 

y ` DA OQMA BQ ® ES t of aa PS 3 
ABeLloer P¿2QAAQA ss Rags A Blo rc rou -H Fa 
Track: use notclass width g Via: use notolass sizes (Ej Grid; 0.1270 mm 10.0050 in) O tomato E 


J 


8 AND VCC J3 GNAW 


à LYS 6/7 
QOO 00 0 O Ore 


Pads Vas Track Sagmanis Nodus Nuts 
m z 383 104 25 
[Session My imported snd merged OK, 2549 — * 110.2980 Y 689000 Bx POTICO. oy BEVOCO dist 101,0163 eit KOTO mm VOIO me men 


Figure 13.16.4.42: The auto-routed board in Pcbnew. 
Pcbnew will replace the rattiest lines with the tracks that FreeRouting drew. Compare the 


PCB in Figure 13.16.4.42 against that of Figure 13.16.4.39 to confirm that the routes are 
identical. 
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In summary, it only took the autorouter a few seconds to fully route this 2-layer board. It 
had taken me over 60 minutes to do the same. 

In the next segment of this chapter, I will show you how to route the same PCB automati- 
cally but this time using four layers instead of two. 


13.16.5. How to use the FreeRouting autorouter 4-layer example 

In the previous segment of this chapter, you learned how to use the FreeRouting applica- 
tion to route a 2-layer PCB automatically. In this segment, you will automatically redo the 
routing, but with four layers. 

To do this demonstration, I will start in Pcbnew and configure the board to use four layers. 
In Pcbnew, open the Board Setup window, and go to Physical Stackup: 


o... Board Setup 
Board Saca tQ trpedence corres Ada Dielectric Layer. 
Board Editor Layers 
Layer id Type Material Thickness a Color EpsiionR Loss Tg 
Board Finish 1 
Soldor Mank/Paste m= F Silkscroon Top Silk Screen Not specified a Wi Not spocifind |» 
Text & Graphics FPaste Top Solder Paste 
Defaults 
Text Variables omer F Mask Top Solder Mask Not specified «0.01 mm i Croon |» 330 o 
Design Rules — fcu Copper 0.035 mm 
Constraints 
Pre-defined Sizes m Dielectric? Core B m 151 mm 4.50 0,02 
Net Classes 
— 
Custom Rulea Int.Cu Copper 0.035 mm 
Violation Severity mu Dielectric 2 PrePreg B Fra m 151mm 450 0.02 
mr in2.cu Copper 0.035 mm 
jm Dielectric 3 Core B Fra 1.51 mm 450 0.02 
am BCu Copper 0.035 mm 
omer Mask Bottom Solder Mask Not specified m  @0Tmm E Green |» 3.30 0 
B.Paste Bottom Solder Paste 
mu E Silkscreen Bottom Silk Screen Not specified ds Ti Not soocitioa Jw 
Board thickness from stackup; 4.69 mm Export to Clipboard 
Import Settings from Another Board... Cancel 


Figure 13.16.5.43: This is a four-layer PCB. 


Also, click on the Board Editor Layer tab to confirm the role of each of the copper layers: 


o... Board Setup 

Board Stackup Add User Defined Layer. 
Physical Steckup FCourtyars Oft-board, testing 
ee Fe Fab Oft-board, manufacturing 
Soldar Mask/Pasto 

Text & Oraphies F.Adhesive On-board, non-copper 
Detautta F.Paste ‘On-board, non-copper 
eos niggers F.Silkscrean On-board, non-copper 

Design Aides x = 
Constraints 
Pre-detined Sizes 
Net Classes 
Custom Rules 


Viclation Severity 


secs 


Otf-board, manufacturing 
B.Courtyard Otf-board, testing 
Edge.Cuts Board contour 

Margin Edge_Cuts setback 


Nene Raat Artt 


3IGecaneaesasg 
m 6: 
Bigg 
E 


Import Settings from Another Board. Cancel 


Figure 13.16.5.44: I have configured the four layers of this PCB as "mixed." 
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I have set all four layers of this PCB as "mixed" to give the autorouter maximum freedom 


in routing tracks that belong to signal or power classes. 
Click "OK" and continue to export the DSN file with File —> Export —> Specctra DSN: 


ji Piac t 
A Save 
EA Save Copy As.. 
Rescue 
E Import LA eeuna 
[ð Export > D Specctra DSN... 
ks Fabrication Outputs > % GenCAD... 
VRML... 
& Board Setup... g 
EA iDFv3.. 
D Page Settings... GA step 
| 5 Print.. SA sve 
E a, Plot: “E, Footprint Association (.cmp) File... 1 


Figure 13.16.5.45: Exporting the DSN file for the four-layer board. 


As you learned in the previous segment of this chapter, start the Freerouter application and 
import the DSN file. The four-layer un-routed board should look like this: 


o + Board Layout 


File Display Parameter Rules Info Other Help 
Select Route Drag Autorauter Unda | Redo incompletes Violations | Zoom All| Zoom Region | Unit: 


Figure 13.16.5.46: The un-routed four-layer PCB in FreeRouting. 
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In Freerouter, click on the Display menu and the "Layer Visibility." This will reveal a small 
window that contains four widgets, one for each layer. You can use those widgets to change 
the visibility of each layer as the autorouter is working. You can keep this window active on 
the side of the Board Layout window to be available to use at any time. 


~ 


Layer Visibility 
Use slider to modify the visibility on layer 
F.Cu 
In1.Cu 
In2.Cu 
B.Cu 
Minimum All Maximum All 
d 


Figure 13.16.5.47: The layer visibility window. 


Before starting the autorouter, take a few moments to look at the Autorouter Parameter 
window (where you can select the preferred track direction for each layer) and the Clear- 
ance Matrix window (under Rule), where you can set minimum clearances for each class 
and layer. 

Start the autorouter by clicking the Autorouter button. A few seconds later, the board is 
fully routed and looks like this: 


File Display Parameter Rules Info Other Help 
Select Route Drag Autorouter Undo Redo completes Violations ZoomAll Zoom Region Unit: 1 w Y 


Postroute completed Via Count: 18 Trace Length: 913,503.5065 cursor: (138,243.8845 103,3... 


Figure 13.16.5.48: The four-layer PCB, fully routed. 
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The PCB is now fully routed and ready to export. Export the Specctra Session file, and im- 
port it to Pcbnew. In Pcbnew, the board looks like this: 


eee *MCU Datalogger — PCB Editor 
ti ` (al A 7%OQOCQ8@ AÀ a e Ta o O sn g y = A + 
E he ASAAQAQA 22 Had A © M Fc (Pav) a 
Track: use netclass width Ej la Via: use netciass sizes Ej | Grid: 0.1270 mm (0.0050 in) © tomato E 
LF 
oon 
ow 
Ta 
JU 
4 
o 
N 
S 
Z Fab 
D mZ 
© veri 
[j mO ow 
3 Une. 
“a mO uwas 
Users 
X mO uws 
o User. 
ig Q User 
[> PLaver Dotar Osio 
“a 
Sis, Pail (cans Tato 
Salnction Fitar 
Peds Vis Trek Segments = Nodes Nets Lnrouted 
n 18 324 104 25 9 
tajan fla imporind and marged OK 1469 X 136-2710 Y 112800 de 196.2710 dy 812800 dist 15612 ara X 0.1270 mem Y 0,1270 mm men 


Figure 13.16.5.49: The four-layer PCB fully routed in Pcbnew. 


You can compare the routes in Figure 13.16.5.48 and Figure 13.16.5.49 to confirm that 
they are the same. You should also perform a Design Rules Check to ensure that there are 
no violations. In my case, the DRC revealed no unconnected items but three violations. 
Here is one example: 
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Layers 


-mOrm 
oe mS meu 


‘eee! mO mc 
Y, m O acu 


Obja. 


Y Refill all zones betore performing ORC Y Tost for parity between PCB and schematic 


Y Report all errors for each track 


Violations (3)  Unconnected tems (0) Schematic Parity (11) 


Error; Clearance violation (netclass ‘Power’ clearance 0.2500 mm; actual 0.2465 mm) 
Track [/SDA] on F.Cu, length 1.8471 mm 
Pad 1 of R3 on F.Cu 

Error: Clearance violation (netclass ‘Power’ clearance 0.2500 mm; actual 0.2481 mm) 
Track [Net-(C2-Pad2)] on F.Cu, length 4,0084 mm 
Pad tof R2 on FCu 

Error; Clearance violation (notclass ‘Power’ clearance 0.2500 mm; actual 0.2485 mm) 
Track [Noc] on F.Cu, length 1.2514 mm 
Pad 4 of U3 on F.Cu 


Show: Y All y Eros O) Y Warnings tb Y Exclusions Save 


Delete Marker Delete All Markers Close Run ORC 


Figure 13.16.5.50: Three clearance violations exist in the autorouted board. 


Violations such as the one in Figure 13.16.5.50 are simple to fix with manual editing. 

In summary, auto-routing is an important tool for any PCB designer and should be used 
with an appreciation of its limits. Autoroutes, in general, are blunt tools that can save you a 
lot of time, as long as you understand their limitations. For any specialized tracks, you will 
still need to rely upon manual drawing. 


13.17. Pcbnew Inspection menu 
In this chapter, you will learn about the functionalities available under the Pcbnew "Inspect" 
menu (Figure 13.17.1). 


KiCad File Edit View Place Route Inspect Tools Preferences Help W 


& BB Net Inspector 


Le D = oc E ® E Show Board Statistics 


: use netclass width Ed 6) Via: use nete E Measure Tool 


Lu 


Ely) Design Rules Checker 


Figure 13.17.1: The "Inspect" menu in Pcbnew. 


We'll begin with the Net Inspector. 
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Net Inspector 
Start the Net Inspector by clicking on Inspect —> Net Inspector. The Net Inspector window 
will appear, and it looks like this (Figure 13.17.2): 


... Net Inspector 
Net name filter: Show zero ped nets 
Group by: Wildcard o 


Net Name Via Length Track Lan 


GND 6,1800 mm 158.8294 
Nec 1.5450 mm 182.9326 
Net-(¥2-Pad2) 0.0000 mm 23,8710 F 
Not-[Y2-Pad1) 3 2 3.0900 mm 
Net-(U4-Pad20) 0.0000 mm 12.9139 n 
Net-(R5-Pad2) 0.0000 mm 3.8204 n 
JScK 3,0900 mm 97.3601 r 
Not-(R7-Pad!1) 2 0.0000 mm 3,8204 n 
{SDA 3.0900 mm 80.3158 r 
1.5450 mm 27.0457 r 
1.5450 mm 28.6104 r 
15450 mm 2188317 
1.5450 mm 14.3606 r 
1.5450 mm 13.6399 r 
1.5450 mm NIN 
1.5450 mm 12.2527 r 
1.5450 mm 27.8139 r 
1.5450 mm 30,6257 t 
1.5450 mm 28.3656 1 
1.5450 mm 27.5867 r 
1.5450 mm 2582301 


Creste Report... 


Figure 13.17.2: The Net Inspector window with a net selected 
and its members highlighted in the editor. 


The Net Inspector window contains a list of the nets in the layout and statistics such as 
the total number of pads, vias, and length of each net. You can click on a net row, and the 
editor will highlight the net members in the layout. You can use the widgets at the top of 
the window to filter and group the nets that the inspector shows in the list. For example, 
type "/D" in the name filter text box, and the inspector will only show nets with names that 
start with "/D." 

At the bottom right corner of the Inspector window is the "Crete Report..." button. Click on 
this button and save the resulting CSV file on your computer. Below you can see an exam- 
ple of this report (Figure 13.17.3): 
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... net_inspection_report.csv — ~/Documents/Kicad/Course development documents/KiCad Like a Pro 3e Projects/MCU Datalogger 
{dt NetinepectorReport.cey x [E] MCU Datalogger rapor x (ult net_inspection_report...x 
1 [Net Code";"Net Name";"Pad Count";"Via Count";"Via Length";"Track Length";"Die 
Length";"Net Length"; 
21;4;6.1800 mm; 158.8294 mm;0.0000 mm;165.0094 mm; 
16 mm; 
.0000 mm;23.8710 mm; 


DO J)O0wun wn =e 


H 
n o 


rH 
N 


2;1;1.5450 mm;28.6104 mm; 0.0000 mm; 30. 1554 mm; 


rR 
> y 


PPR 
Jm Un 


N NN NN NN 
On e WN +» su 0 


N 
A 


| ¡Documente/Kicad/Course development documenta /KiCad Lite a Pro 3e ProjectsMC LF UTF-8 Pisin Text P 2-experimental @Nosemote ()Gimub ©GH(4) C Supaam W 


Figure 13.17.3: The Net Inspector exported report. 


The report contains the same information that you see in the inspector window in a text 
CSV format that you can use with spreadsheets for further processing. 


Board Statistics 


Start the Board Statistics by clicking on Inspect —> Show Board Statistics. The Board Sta- 
tistics window will appear, and it looks like this (Figure 13.17.4): 
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boe Board Statistics 
General Drill Holes 
Components Pads 
Front Side Back Side Total Through hole: 25 
THT: 7 0 7 SMD: 88 
SMD: 18 0 18 Connector: 0 
Total; 25 o 25 NPTH 4 
Total: “7 
Board Size Vias 
Width: 51.4350 mm Through vías: 23 
Height: 34.2900 mm Bline/buried: 0 
Area: 1354.4833 sq. mm Micro vias: 
Total: 23 
‘Subtract holes from board area Exclude components with no pins 


Generate Report File.. 


Co Shape =X Size YSize Plat.. Via/, 
[Be] Round 1.0000 mm 1.0000mm PTH Pad 
23 Round 0.4000 mm 04000mm PTH Via 
4 Round 21000mm 21000 mm NPTH Pad 


Generate Report File.. 


Board Statistics 


General Drill Holes 


R 


Start Layer 
F.Cu 
F.Cu 
F.Cu 


Close 
Stop Layer 
B.Cu 
B.Cu 
B.Cu 
Close 


Figure 13.17.4: Board Statistics. General (top), Drill Holes (bottom). 


The Board Statistics window contains two tabs. The General tab provides information about 
the types of components used in the board, pads, vias, and the board dimensions. The 
Drill Holes tab offers information about the drills, how many are present in the PCB, their 
dimensions, and start and stop layers. 

You can generate a text report that contains all of this information, which looks like this 


(showing a segment only): 
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EF) board_stats_report.txt — ~/Documents/Kicad/Course development documents/KiCad Like a Pro 3e Projocts/MCU Datalogger 
dale NetinewectorRepertcry x E) MCU Dutatogger repor- x blt netnapection.yeport.. El boerd stata reponit x 


PCB statistics report 


— Date: Wednesday, 28 July 2021 at 08:43:23 am 
Project: MCU Datalogger 
Board name: MCU Datalogger 


Board 


- Width: 51.4350 mm 
- Height: 34.2900 mm 
- Area: 1354.4833 sq. mm I 


Pads 


- Through hole: 25 
- SMD: 88 

- Connector: @ 

- NPTH: 4 


Vias 


Through vias: 23 
Blind/buried: @ 
- Micro vias: 0 


Components 


Figure 13.17.5: The board statistics text report. 


Measure tool 
You can invoke the Measure tool from the Inspect menu ("Measure tool"), or from the right 
toolbar: 


ES) Net moros MCU Datalogger — PCU Editar 


> | stron Koara sertes GA Bie foo č -H ES 


Aute 


SS 


000000000*%5000000000000000000 ` 


Figure 13.17.6: The Measure tool. 
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You can use the Measure Tool to make quick distance measurements between any two 
points in your PCB. Enable the tool, and then click on the layout editor to start measuring, 
then click again to finish: 


Route Inspect Tools Preferences Help Window 


MCU Datalogga 


TQQQQQL 2 Had BH Si Mecro 


se netclass sizes (Y Grid: 0.1270 mm (0.0050 in) @ Zomato Ej 


Figure 13.17.7: The Measure tool in action. 


Design Rules Checker & Markers 
I discuss the Design Rules Checker in detail in dedicated chapters (see here and here). 
The Inspect menu include three related options: 

e Previous Marker. 

e Next Marker. 

e Exclude Marker. 


The options allow you to navigate through the results of the DRC by clicking on the menu 
items, or typing the set hotkey. For example, suppose that the DRC contains these results: 


o o DRC Control 


© Refill all zones before performing DRC © Test for parity between PCB and schematic 
Report all errors for each track 


Violations Unconnected items Schematic Parity 


Pad 8 of UA on F.Cu 

Warning: Pad missing net given by schematic (unconnected-(U4-Pad13)). 
Pad 13 of U4 on F.Cu 

Warning: Pad missing net given by schematic (unconnected-(U4-Pad14)). 
Pad 14 of UA on F.Cu 

Warning: Pad missing net given by schematic (unconnected-(U4-Pad19)). 
Pad 19 of UA on F.Cu 

Warning: Pad net (Net-(U4-Pad20)) doesn't match net given by schematic (Net-(C4-Pad2)), 
Pad 20 of U4 on F.Cu 

Warning: Pad missing net given by schematic (unconnected-(U4-Pad22)). 
Pad 22 of U4 on F.Cu 

Warning: Pad missing net given by schematic (unconnected-(U4-Pad23)). 
Pad 23 of U4 on FCu 

Warning: Pad missing net given by schematic (unconnected-(U4-Pad24)). 
Pad 24 of U4 on FCu 

Warning: Pad + Re net given by schematic (unconnected-(U4-Pad25)). 


at Me ati 


Show: Alt Errors Warnings Exclusions Save. 


Delete Marker Delete Al Markers 


Figure 13.17.7: The DRC results. Click on a row to highlight the source. 
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You can navigate through the DRC rows by 

. Clicking on a row. 

. Clicking on the marker options inside the Inspect menu. 

. Typing the corresponding hotkeys (for my setup, Option-Shift-Left for Previous 
Marker, and Option-Shift-Right for Next Marker). 


an BR WwW 


You can assign custom hotkeys in the Preferences window, Hotkeys. 


Clearance Resolution 

This option will generate a report about the clearance resolution between two selected 
items on the board. 

For example, in my test board below I have selected two adjacent capacitors (hold the 
Command or Control key down, then click on the items you can to select). Then, click In- 
spect and "Clearance Resolution": 


Route Inspect Tools Preferences Help Window 


B Net Inspector MCU Datalogger 


oy Show Board Statistics ral a o 2d iA af to H F.cu (PaUp} 


se nete o Measure Tool n) G zomat B 


Figure 13.17.8: Select two items from the board, then click on Clearance Resolution. 


Pcbnew will open up a new window with the report: 


© ə Clearance Report 


Clearance resolution for: 
+ Layer F.Cu 
+ Footprint C3 
© Footprint C1 


k 


Checking board setup constraints: clearance: 0.0000 mm, 
Unconditional constrain applied. 


-i :3 “e E Checking netclass ‘Default, clearance: 0.2000 mm. 


Membership not satisfied; constraint ignored. 


C10. 4UFC32 pF 


Checking netclass 'Power', clearance: 0.2500 mm. 
Membership not satisfied. constraint ignored 


Resolved clearance: 0 mm, 


Figure 13.17.9: The clearance resolution report for the two capacitors. 
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This report will tell you if two items violate any clearance rules. In this example, there are 
no violations. 


Constraints Resolution 
Select one item from the board to use the Constraints Resolution tool, then click on Inspect 
and Constraints Resolution. In the example below, I have selected the MCU footprint: 


Route | inspect Tools Preferences Help Window 
MCU Datalogger — PCB Editor 


Ed Net inspector 
A Z | Show Board Statisties had SAM ¿Bes Er pap -B 
n) 


via: use nate g Measure Tool 


® = Zoom Auto 


Figure 13.17.10: Select one items from the board, then click on Constraints Resolution. 


Pcbnew will open up a new window with the report: 


Constraints ES 


Keepouts 


Keepout resolution for; 
+ Footprint U4 


Checking board setup micro-via constraints, 
Keepout constraint not met. 


Checking board setup constraints. 
Keepout constraint not met 


ltem allowed at current location. 


Figure 13.17.11: The Constraints report for U4. 
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The report provides information about vias, keep outs, location, and perhaps other con- 
straints that I have not noticed up to the time I am writing these lines. 

The report may indicate that certain constraints are not met (such as the keep out con- 
straint in the example above). In my experience, the report may contain cases of possible 
violations that may or may not cause problems in your layout, and it supplements but does 
not substitute the Design Rules Check. 


13.18. Single track and differential pair routing 

Pcbnew offers you two modes to do routing (that is, to create copper tracks): single track 
and differential pair tracking. You can select the mode via the buttons in the right toolbar 
or the top menu (Figure 13.18.1). 


Place Route € Tools Preferences Help Wir 


È set Layer Pair... 


r” Route Single Track 


13 
> Route Differential Pair E 


\ F.Silkscreen 
BSilkscreen 


(©) User. Drawings 
(e) User Comments 
Qe) User.Ecol 

a [o] User.Eco2 

B [e] Edge.Cuts 


En Margín 
E F.Courtyard 
Ez © sB.couryard 


Figure 13.18.1: The two routing modes and how to enable them. 


To choose a routing mode from the right toolbar, click and hold on the routing icon to ex- 
pand it, and then click one of the two options. 

By default, the single-track routing mode is selected. You probably have already used this 
mode as I have used it extensively throughout this book. In this chapter, I will formalize 
this knowledge and show you how to do differential pair routing. 

I will begin this demonstration in Eeschema and design a simple schematic that consists 
of two 9-pin headers. I have used net labels that contain a single letter (like "A" or "B"), 
or a letter followed by "+" and "-", or "_P" and "_N". Here is my demo schematic (Figure 
13.18.2): 
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Conn_01x09_Male Conn_01x09_Male 
ji 


Figure 13.18.2: This schematic contains single nets and differential pair nets. 


In the schematic above, I have used wires to connect pins 8 and 9 of J1 and J2. I have 
made the rest of the connections via the net labels. 

A net label that ends with "+" and "-" or "_P" and "_N" represent differential pairs. In a dif- 
ferential pair”, information is transmitted between the transmitter and the receiver using 
signals that travel through two wires. The signal levels (i.e., their voltage) are the same, 
but their polarity is the opposite. Examples of technologies that utilize differential pairs 
include DDR SDRAM, PCI Express, Serial ATA. 

In KiCad, we can identify differential pair pins using the "+"/"-" or "_P"/"_N" notation. For 
example, a pin labeled "data+" and "data1-"consists of a differential pair. Pins with labels 
"“data1_P" and "datai_N" also consist of a differential pair. You can use either postfix, but 
do not mix them. For example, "datai+" and "data1_N" do not consist of a differential pair. 
Let's continue with this example. Import the schematic to Pcbnew so that you have this 
un-routed layout (Figure 13.18.3): 


Conn_01x09_Male Conn_01x09_Male 


Figure 13.18.3: The un-routed layout. 


22 https://en.wikipedia.org/wiki/Differential_signalling 
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Notice that the net names are inherited from the schematic in Eeschema and appear on the 
pads. We'll use this information to help distinguish between single tracks and differential 
pairs. 

For pads "A", "B", and "C", we'll use single track routing since they don't have the "+"/"-" or 
"_P"/"_N" postfix are single tracks. Click on the single-track routing mode button from the 
right toolbar (or select "Route Single Track" from the "Route" menu, or type the "X" hotkey 
on your keyboard). With the single-routing mode selected, click on a pad to start drawing, 
then click again on the closing matching pad to finish drawing (Figure 13.18.4). 


cocos f 
perie 
154 
eccaca 


3 


Figure 13.18.4: Single-track drawing. 


You can create angled track segments by right-clicking. To complete the track, click on the 
corresponding pad. The thin rattiest lines can help you find and see the matching pad by 
linking it with the line and highlighting it so that it stands out from the rest. 

Let's continue with the differential pars. I'll start with the pair "A+" and "A-". You can route 
a differential pair as if it was a single pair. Try this out, and confirm that it works. But a 
better way to route differential pairs is to select the differential pair routing mode. 

Select the differential pair routing mode by clicking on the button with the two lines from 
the right menu bar (see "2" in Figure 13.18.1), or click on "Route Differential Pair" under 
the Route top menu, or just type the "6" hotkey on your keyboard. 

With the differential pair routing tool selected, start by clicking on either of the two pads 
that make up the pair to start drawing ("1" in Figure 13.18.5 below). Continue to draw the 
two tracks as you navigate the pair closer to the target pads ("2", below). You can click to 
change directions as if you were drawing a single track. To finish drawing, click on either 
pair's target pads ("3", below). 
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e 


Figure 13.18.5: Drawing differential pair tracks. 


Your differential pair tracks is complete. Drawing a differential pair track is very similar to 
drawing a single track when it comes to elements such as adding segments to make the 
track go around other elements, and vias. You can see examples of this in Figure 13.18.6 
below. The pairs "A_P"/"A_N" and "B+"/"B-" contain multiple segments and vias. To create 
a via, the easiest way is to use the "V" hotkey while you draw. 


Conn_01x09_ 


Figure 13.18.6: Differential pair tracks with multiple segments and vias. 
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13.19. Track length tuning 

In this chapter, you will learn how to tune the length of a single track or a differential pair. 
Track length tuning is a function that allows you to tune the length of a track or differential 
pair so that it is an exact value. By tuning the length of a track, you can ensure that a signal 
can propagate from origin to destination in a specific amount of time. Track length tuning 
is important for applications such as in memory data or address buses, where signals that 
belong to the same bus must arrive at the destination within specific timeframes. 

The two tools that you will learn about in this chapter can increase the total length by in- 
troducing new and repeated segments (meanders). You can set the target length, and the 
tool will draw enough new meanders to achieve that goal. 

You can access the single track length tuning and differential pair length tuning tools via the 
top menu, under Route, or via the right-side toolbar (Figure 13.19.1): 


Place Inspect Tools Preferences Help Wi 


v Set Layer Pair... 


a: use ne 
~> Route Differential Pair 


r/ Route Single Track 


User.Drawings 
User.Comments 
Usar. Ecol 

User, Eco 
Edge.Cuts 
Margin 
F.Counyard 
BCourtyard 
Ffab 


Figure 13.19.1: The two-track length tuning tools. 


Let's look at an example of how length tuning works. We'll use the layout from the previous 
chapter, which looks like this (only showing the top two tracks): 
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v Set Layer Pair... Blank P 


Ho 2 Had CGA Y 
i r Route Single Track 3 

| Via: use ne © 2zoomsoo E 

~> Route Differential Pair 


Tune length of a sing! Ro 7 


Tune length of a differéncial pair 8 
_ Tune skew of a differential pair 9 


JŽ Interactive Router Settings... ox, 


Figure 13.19.2: Fine-tuning the length of a single track. 


In Figure 13.19.2 (above),I will increase the length of the track that connects pad 1 of J1 
and pad 1 of J2 ("1"). Start by clicking on "Tune length of a single track" from the Route 
menu ("2"). I prefer to use the hotkey for this tool, which is "7". Click anywhere on the 
track, but preferably towards the left or right end so that you have enough space to draw 
the new segments. I'm starting towards the left end of the track ("3"). Start moving the 
mouse towards the right end of the track (or whichever way most of the track lies), and 
notice the new segments have the shape of a meander. When the label that shows the cur- 
rent and target length becomes green, click again to finish the drawing ("4"). The length 
of the track is now tuned. 

It is possible to configure how the length tuner tool works, including the target length. To 
do this, enable the single (or differential pair) length tuner from the menus or using the 
hotkeys ("7" for the single length tuner, and "8" for the differential pair length tuner), and 
then click on "Length Tuning Settings." Below is the tuning settings window: 
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e Single Track Length Tuning o e Differential Pair Length Tuning 


Length {Sean Length / Skew 


Targetiengihi 50 Target length: 50 


Meandering Meteng 


Min amplitude (Amin): Min amplitude (Amin); 0.1 
Max amplitude (Amax]: 1 n Mac amplitude (Amax): 11 
Min spacing (s): k Min spacing (s): 01 
Miter style: c r Miter style: arc 


Mitar radas (r} we 4 Miter radius (1) 


Figure 13.19.3: Length tuning settings for single track and differential pair. 


The length tuning settings for both single track and differential pair are very similar. You 
can control the minimum and maximum amplitude, the spacing between the adjoining seg- 
ments of a meander, the style (arc or 45 degrees), and the radius. Below you can see the 
difference between the arc and 45-degree styles: 


Figure 13.19.4: Meander styles. Arc (left) and 45 degree (right). 


Figure 13.19.4: Meander styles. Arc (left) and 45 degree (right). 

You can tune the length of a differential pair by selecting the tool "Tune length of a differ- 
ential pair" from the Route menu or typing the hotkey "8". Use the same drawing process 
as with the single track. A length-tuned differential pair looks like this (Figure 13.19.5): 


Figure 13.19.5: Length-tuned differential pairs. 
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In the examples above, I have created two separate meandering segments in the top one. 
The bottom differential pair includes two vias in the middle. The length tuning tool cannot 
continue drawing past a via or pad, so I had to stop the drawing and then create a new 
meandering segment on the other side to achieve the required length goal. 

It is also possible to change the spacing and amplitude of the meander during drawing. You 
can do this using the hotkeys 1, 2, 3, 4 (active only during length-tuning drawing) or via 
the context menu (Figure 13.19.6). 


2 
3 
4 


FNI Decrease Amplitude 
gy Length Tuning Settings... 38L 


Figure 13.19.6: Space and amplitude control in the context menu. 


By increasing or decreasing the amplitude and spacing of the meander, you can change the 
total footprint on the PCB required by the meander. Of course, as the amplitude gets bigger, 
the track will need more space around it. 

The Route menu contains one more tuner, which you can use to tune the skew of a differ- 
ential pair. You can learn more about this in the next chapter. 


13.20. Differential pair skew tuning 

In the previous chapter you learned how to tune the length of a single track or a differential 
pair. In this chapter, I'll show you how to use another tool in the Route menu, "Tune skew 
of a differential pair." 

Differential skew? is a phenomenon that appears in high-speed, high-frequency appli- 
cations. The phenomenon refers to the time difference between the two signals in a dif- 
ferential pair. In high-speed applications, a tiny difference in the time it takes for the two 
differential pair signals to travel to their destination can cause significant processing prob- 
lems. Such a system would need to have the capability to detect data losses caused by the 
differential skew and recover. If we can minimize the differential skew as much as possible, 
then the system would spend less time recovering lost or corrupt data, and its overall per- 
formance would increase. 

A common cause of differential skew is the difference in length of the two tracks that make 
up the pair. The differential pair skew tuner allows you to tune one pair of tracks inde- 
pendently of the other to minimize or eliminate the differential skew caused by the track 
length difference. 

To use the tool, choose "Tune skew of a differential pair" from the Route menu, or type the 
"9" hotkey, or select it from the right toolbar (Figure 13.20.1): 


23 Fora discussion on differential skew, see https://www.edn.com/handling-differential-skew-in-high- 
speed-serial-buses/ 
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Route inspect Tools 


v Set Layer Pair... 


ri Route Single Track 


7 Route Differential Pair 


Preferences 


Figure 13.20.1: The differential pair skew tuner tool. 
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Let's look at an example of how to use the differential pair skew tuner tool. My starting 
point is a simple straight differential pair track, as you can see below: 


Figure 13.20.2: We'll tune the skew of this differential pair. 


Imagine that the signal that flows through the top track ("A+" net) arrives at its destination 
slightly sooner than the bottom track. Maybe the material used is different, or perhaps 
the geometry of the track for track of net "A-" is such that it causes a delay. Whatever the 
reason, I would like to equalize the signal's propagation time by introducing a slight delay 
in the top track. 
First, I will find out how long are each of the tracks makes up this differential pair. You can 
use the Net Inspector for this under the Inspect menu. Invoke the Net Inspector and click 
on the "A+" and "A-" nets to see their rows. 


Net 


Net name filter: 


Group by: 
Name Pad Count 

001 JA 2 

002 iB 2 
2 
2 
2 
2 

007 JAN 2 

008 [B+ 2 

009 /B- 2 

4 ú ' 


Via Count 


o 


Naaa opoo 


Net Inspector 


Via Length 
0.0000 mm 


0.0000 mm 
0.0000 mm 


Track Length 
60.0000 mm 
30.9880 mm 
30.9880 mm 
31.9396 mm 
31.9396 mm 
58.1122 mm 


0.0000 mm 
6.4000 mm 


6.4000 mm 57.4394 mm 
3.2000 mm 33.8908 mm 
3.2000 mm 33.0251 mm 


Show zero pad nets 


Wildcard Go 
Die Length Total Length 
0.0000 mm 60.0000 mm 
0.0000 mm 30.9880 mm 


0.0000 mm 


AAA 
31.9396 mm 


31.9396 mm 


0.0000 mm 
0.0000 mm 


0.0000 mm 
0.0000 mm 37.0908 mm 
0.0000 mm 36.2251 mm 


Create Report... 


63.8394 mm 


Figure 13.20.3: The current length of the two tracks in the example differential pair. 
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The two tracks in the example differential pair have an equal length of 31.93 mm. I will 
tune the length for the "A+" track to 35 mm. 

Select the "Tune skew of a differential pair" tool from the Route menu (I prefer to type the 
"9" hotkey). Then, right-click on the top track of the differential pair to show the context 
menu and select Length Tuning Settings. The window that appears looks like this: 


o e Differential Pair Skew Tuning 
Length / Skew 
Target skew: [35 3 mm 
Meandering 
Min amplitude (Amin): 0.1 mm 
Amax Max amplitude (Amax): 1.4 mm 
r Min spacing (s): 06 mm 
Miter style: arc & 
Miter radius (r): 100 % 
cancel ND 


Figure 13.20.4: The Differential Pair Skew Tuning window. 


Change the Target skew to 35 mm. The rest of the settings are fine as they are. Click OK. 
Concerning figure 13.20.5, move the mouse towards the right to start drawing the new 
meandering segment and notice how the values in the label change (1). When the length 


reaches 35 mm, the label becomes green as I have attained the set target. Click again to 
finish drawing (2). 


Figure 13.20.5: Increasing the length of one of the tracks in a differential pair. 


The differential pair track now has a slightly different length. The track that belongs to the 
"A+" net is somewhat longer than the track of "A-. " 


13.21. Interactive router modes 


KiCad 6 contains an advanced interactive router. This interactive router assists you as you 
draw traces. For example, the router can do things such as: 
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Highlight violations, such as trying to draw a trace over a pad or another route. 

e Automatically push traces aside to make room for the trace you are currently 
drawing. 

e Find a route around an obstacle when the obstacle is immovable. 

e Optimize the geometry of the track as you draw it. 

e Remove redundant tracks as you draw new tracks between the same endpoints. 


The interactive router in KiCad 6 has three modes: 
e Highlight collisions. 
e Shove. 
e Walk around. 


You can find the interactive router settings under Route —> Interactive Router Settings: 


© Interactive Router Settings 
Mode 
Highlight collisions 
Shove 

O Walk around 


Options 


Mouse drag behavior: Move item 


Jump over obstacles 
© Remove redundant tracks 
Optimize pad connections 
Smooth dragged segments 


Optimize entire track being dragged 
© Use mouse path to set track posture 


Fix all seaments on click 


Cancel 


Figure 13.21.1: The Interactive Router Settings window. 


You can choose a mode by selecting one of the radio buttons in the Mode group of the set- 
tings window. You can configure the specific features of each by selecting them from the 
Options group of widgets. 

In this chapter, you will learn how to use the three interactive router modes. 


Walk around 

First, let's look at "Walk around." This is the mode I use most often. Ensure that "Walk 
around" is selected in the Mode group, and click "OK." 

To test this routing mode, I am using a layout from one of the projects in this book. You can 
see my starting layout in Figure 13.21.2, frame 1. I have deleted the trace between the two 
Vcc pads. Then, I typed "X" to enable the single trace drawing tool. To understand what is 
happening in these screenshots, I use a green circle to mark the track origin and an orange 
circle for the mouse pointer's position, and trace ends. 
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Figure 13.21.2: The interactive router in "Walk around" mode. 


In frame 2, I start drawing a new track from pad 2 of the Serial connector. There are sev- 
eral tracks and pads that block the path of the new trace. Notice that the mouse pointer is 
towards the left of the screenshot, beyond the blocking pads and traces of the two capacitor 
footprints. My new trace cannot find a path through those obstacles and remains separated 
from the mouse pointer. There is no path through. 

In frame 3, I could navigate the new trace around the right side of the I2C connector, in 
between the VCC and GND pads. The new trace path took it over an existing trace that also 
belongs to the Vcc net. Because both traces belong to the same net, there is no violation, 
and the interactive router did not block the drawing. 

In frame 4, I deleted an existing trace between the Serial connector pad 1 (GND) and pad 
1 of C1. I did this to draw a new trace towards the left side of the PCB. You can see the 
new trace starting from the Vcc pad (in the green circle) until it reaches the left edge of 
the screenshot. 

In "Walk around" mode, the Interactive router will not make any automatic changes to the 
layout. It considers all elements as fixed. The router will try to find a path around existing 
elements taking a queue from the movements of the mouse pointer. 

In my experience, the "Walk around" mode is the safest one to use, and I use it as my 
default. 
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Shove 

Let's continue with Shove. Bring up the Interactive Router Settings window from the Route 
menu, choose the Shove mode, and click OK. I'll use the same layout as in the "Walk 
around" demo to demonstrate how Shove works. You can see my starting layout in Figure 
13.21.3, frame 1. 


Figure 13.21.3: The interactive router in Shove mode. 


In frame 1, notice how the new trace and mouse pointer are a few pixels below an existing 
trace in the front copper layer. In frame 2, I have moved my mouse pointer a few pixels 
higher in the area that earlier was occupied by the existing trace. The interactive router has 
highlighted the collision by giving a bright "halo" to the affected track, and it has used the 
affected track upwards to make room for the new track. Even though a collision is detected, 
the interactive router resolves the violation by moving the existing trace out of the way. 
In frame 3, I move the mouse pointer towards the via, which occupied the space below pad 
2 of the capacitor footprint. Again, the interactive router detected the collision and resolved 
the violation by moving the via (and the traces connected to it) out of the way. 

In frame 4, I have drawn a new trace towards the left side of the board. The interactive 
router re-positioned any existing traces that were in the way. 

The interactive router will try to push existing items out of the way if the conditions are 
favorable for this to happen. If an element, like a via, or trace, is marked as "locked," the 
router will keep them in place. It is also possible for the geometry around a trace of via to 
be such that moving is impossible; perhaps there is no space available. 
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Highlight collisions 
Let's look at the last mode, Highlight Collisions. 
Bring up the Interactive Router Settings window from the Route menu, choose the Highlight 
Collisions mode, and click OK. To demonstrate how Highlight Collisions works, I'll use the 
same layout as in the Walk around demo. This mode only provides violation feedback. It will 
not attempt to make any changes to the layout, and will not make any effort to go around 
existing elements trying to optimize its geometry. This mode gives you maximum freedom 
to draw a trace. It will even allow you to violate design rules. 
Refer to Figure 13.21.3 (below). 
W N A lee 17 09 1-1 
| 7 m E 


ROA? 


Figure 13.21.3: The interactive router in Highlight Collisions mode. 
Green indicates a violation. 


In frame 1, I am drawing a new trace over existing elements. The interactive router will 
not enforce the design rules or find a legitimate path for the trace. It will simply highlight 
any violations in green. 

Further, the router will not block me from committing a new trace that violates the design 
rules. In frame 2, I have drawn a new trace with a path that goes over tracks and pads that 
belong to other nets. 

As you can see, the interactive router in Highlight Collisions mode is permissive. Use with 
care. 

Typically, I will do the bulk of my work in "walk around" mode. Occasionally I will switch 
to Highlight Collisions mode to deal with difficult situations where "walk around" mode just 
gets in the way. I rarely use Shove mode because I prefer not to have my carefully drawn 
tracks altered by KiCad. 


13.22. The footprint wizard 

KiCad ships with an extensive library of footprints. If you need a footprint that is not avail- 
able in those libraries, there is a good chance that you will be able to find it in repositories 
like Snapeda. But even if that fails, you can create custom footprints using one of two tools 
that KiCad provides: the Footprint Editor and the Footprint Wizard. You can learn how to 
use the footprint editor in a dedicated chapter elsewhere in this book. 

In this chapter, you will learn how to use the Footprint Wizard. With the footprint wizard, 
you can create a custom footprint for a standard set of components quickly and easily. 
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The wizard is part of the footprint editor. To use the wizard, start the footprint editor from 
the main KiCad project window (see frame 1 in Figure 13.22.1). 


& do hee 
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Figure 13.22.1: Starting the footprint wizard. 


Once in the footprint editor, click on the Wizard button in the top menu (2). 

The wizard will take you through a series of steps. In the first step, you will select the foot- 
print generator that is most appropriate for the type of footprint that you want to create. 
There are generators for BGA, QFN, DIP, SOIC, and many more types of components. 


Create a DIP footprint 


For this demonstration, I will create a new footprint for a DIP component. From the list of 
available generators, I will choose row 8, "S-DIP" (Figure 13.22.2), and click OK. 


4 CBB CQAQQS 
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Touch Sider 
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Bal Grid Array Footprint Wizard 
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Quad Flat Package (QFP) footprint wizard 
Wizard for Mutual Capacitance Touch Buttons 
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ZOIC, etc, Footprint Wizard 
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Figure 13.22.2: The footprint wizard, 


footprint generators window. 
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I remind you that earlier in this book, I used the footprint editor to create a DIP footprint 
manually. This is an opportunity to experience how the wizard can speed up the work for 
standardized footprints. 

When you dismiss the footprint generators window, the footprint wizard will display its de- 
fault settings in the right design pane. On the left side is a list of parameters that you can 
edit and customize the footprint (Figure 13.22.3). 


ece Footprint Wizard [$-O1P] 
a CBB ZAIDA g 

portes 
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pad count 24 integer 
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pad pitch 254 mm 
padwidth 12 mm 
pad length 2 mm 
row spacing 752 
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Footprint Wizard Name: — S-DIP 
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Footprint Wizard 
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Figure 13.22.3: The Footprint Wizard with the default Pad 
settings from the DIP generator. 


As you change the settings in the parameters pane, the wizard updated the footprint in the 
right pane. 
I made these changes: 

e Pad count to 32. 

e Pad pitch to 1.54 mm. 


In the left pane, click on Body. This will show body parameters in the middle pane (Figure 
13.22.4): 
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Footprint Wizard [S-DIP] 


eE EREREEEEFERE: 


Bullding new KiCad FP Wizard footprint with the following rp SE 


paramotors 

Footprint Wizard Name: — S-DIP 

Footprint Wizard Description: Single/Oual inline Package 
Footpeint Wizard 


= EFEFEFFEREPEFEFEEE 


row count: 2 

pad pitch: 154mm 

pad width: 1.2mm 

pad length: 2mm 

row spacing: 752mm 
dril size: 08mm 

Body 

silk screen inside: False 
outline x margin: 0.5mm 
outline y margin: 0.5mm 


apre Ronn Ratsion — Pooiprmt-DIP-32 206,211 Doc 
DIP-33 308 ELL Artributes: o 20-Shape: «ranes Meyrords 
2779 X-15:8759 Y-3,4290 dx -158750 dy +34290- dint 16.2511 grid X0:1270 mm Y 0.1270 mm mm 


Figure 13.22.4: The Body parameters in the footprints wizard. 


I have made a couple of changes in the body parameters: 
e Outline x margin to 1.5 mm. 
e Outline y margin to 1.5 mm. 


Below you can see my new footprint. It took me around 60 seconds to design: 


0009809000090990 


DIP-—323296ELt 


9000909009099000096 


Figure 13.22.5: Done in 60 seconds. 


When you finish work on your new footprint, you can export it from the wizard to the foot- 
print editor by clicking on the import button: 
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eee 
i oO BB CAQe 
Parameters 
| Body Ipad count 32 integer 
row count 2 Integer 
[pad pitch 1.54 mm 
pad width 1.2 mm 
[pad length 2 mm 
[row spacing 7.52 mm 
‘drill size 0.8 mm 


Figure 13.22.6: Import the footprint into the footprint editor. 


In the footprint editor, you can continue to customize your new footprint or save it into 
an existing or new library so you can use it in a project. If you don't know how to do this 
or need a refresher, see Create a custom footprint, 4, Silkscreen layer from earlier in this 
book. 


Create a Barcode 

The footprint wizard contains a 2D Barcode and QRCode generator. You can use this gen- 
erator to create bar-code graphics that encode information such as a webpage URL with 
information about your board so that the end-user will not have to type the URL. 

I'll show you how that works. 

Start the footprint wizard, select the "2D Barcode QRCode" row, and click OK. The wizard 
will show you this default QR code: 


eee Footprint Wizard [2D Barcode QRCode) 
oun » am 
w <BRBCZOAQQS8 
CS 
code Parameter Value Units 
Caption Qr Pixel Width 05 mm 
Border Margin (Px) © integer 
Contents Exampl string 
Negative bool 
Use SUKS layer bool 
Use Cu layer O bool 


Building new XiCad FP Wizard footprint with the 
tollowing parameters: 
Footprint Wizard Name: — 2D Barcode QRCode 
Footprint Wizard Description: OR Code barcode 
generator 
Pages: 2 
[Barcode 

Qr Pixel Width: 0.5mm 

Border Margin (Px): 0 

Contents: ‘Example’ 

Negative: False 

Use SilkS layer: False 

Use Cu layer: True 
Caption 

Enabled: True 

Haight: 1.0mm 

Width: 10mm 

Thickness: 0.18mm 


grer Status Rotation Footprint: Example: Doc 
Example  Attribytes ° 20-Shepe <rone> Keywords: 


2696 x-41990 ¥-1.8510 Ex -41010 dy 18510 diet 45045 SKOTO mm Y 0,1270 m mm 


Figure 13.22.7: The default QR code in the footprint wizard. 


In the Barcode parameters, I have changed the contents field to "techexplorations.com". 
In the Caption parameters, I changed heigh and width to 1.5 mm. 
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Continue as you would with any other wizard-generated footprint: 
1. Export the footprint to the footprint wizard. 
2. Save the new footprint to a new or existing footprint library. 
3. Use the new footprint in your project. 


Below you can see my new QR code footprint on a PCB, in the 3D viewer: 


techexplorations con | 


Figure 13.22.8: A QR code footprint generated by the footprint wizard. 


13.23. Pin and wire highlighter tool 
It is often difficult to see which pins are connected to other pins in busy schematics and 
quickly determine which wires belong to the same net. To help in such situations, KiCad 


provides a tool called "Highlight wires and pins of a net." You can find it on the top of the 
right toolbar in Eeschema: 


YN EVA > 


Figure 13.23.1: The "Highlight wires and pins of a net" tool. 


I'll show you how it works. 
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Click on the highlight button in the right toolbar to enable the tool. In the example below, I 
have clicked on one of the wires or pins that belong to the GND net. The highlighter marked 
all GND net member wires and pins in pink: 


pl ma 
re ES pores 
qe fal ew clock ais m 7 
+ ameazas | 
A Yer PWRILAS 
> | 1 ua | : 
ne us 
u y 
e 
TO E m 
| 10001 | 
kh i = anen | 
« fe a = ie | 
at aw ca v 
: d ua 
( v > | 
fas 
a heed 
a Lam .. 
m marma aa | 
la Ko ra 
> > > 
aw ov a 
ew: 
cD 
termon $ 
1 si v 
on 100 mu 
| o ma 
we mal 
a | $s 
- us n mo 
cio ü are e 
x miS e i b mans 
i p. 
3 w A ma 
reife Fain Maf za si: wera 
sal x are Lp are ty 
«alo o BS pe ae 
files correct bed 
> > 
ow ow 
| Title: MCU Datalogger with memory and clock 
tigrigna rat: GAO tin ne vrse AIBO y 700 dist 15] 


Figure 13.23.2: All members of the GND net are highlighted in pink. 


Also, notice the message that appears in the status bar (bottom left corner), indicating the 
highlighted net is "GND." 

Unfortunately, if your schematic spans multiple pages, the net selection will not carry 
through from one to the other. 

By default, the highlighter color is light pink. If you'd like to change it to something else, 
like red, you can do so via the preferences window. Go to Preferences, Schematic Editor, 
Colors, and look for "Highlighted items." Click on the color box to bring up the color picker 
and choose a different color. Click OK to exit the Preferences window. 

Below you can see the members of the GND net highlighted in red. 
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C4 PWR_FLAG 
0.LuF Us oS 
ATMEGA328P-AU 
RS | Voc 
330 r, 
c5 

_—_ 100nF Mid 
c2 
22pF 

dy 02 

Y LED 
c3 
22pF 

R7 
JH 330 
— 1 
GND GND Pu 
lo O) PWRFLAG 
> Y 
GND GND GNO 


Figure 13.23.3: All members of the GND net are highlighted in red. 


13.24. Pcbnew Origins 

KiCad, as with any other CAD application, has a coordinate system. In Eeschema and Pcb- 
new, you can see the coordinates of your mouse cursor at the status bar. By default, the 
origin of the coordinate system is located at the top left corner of the editor. The X (vertical 
axis) and Y (horizontal axis) coordinates increase as you move your mouse down and left 
of the origin. 

In Eeschema, you can see the X and Y values at three sample positions: 


Figure 13.24.1: The default coordinate origin in Eeschema. 


Similarly, you can see the default coordinate origin in Pcbnew below: 
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Figure 13.24.2: The default coordinate origin in Pcbnew. 


In Eeschema, it is not possible to change how the coordinate system works. This is not a 
problem since Eeschema is electrical design software, and the coordinate system does not 
need to relate to "real world" coordinates. 

Pcbnew, however, is different. Pcbnew produces real-world output because the PCB that 
you design in the layout editor will yield files containing coordinates that the PCB manu- 
facturing equipment must use. It is also possible that part of your PCB design toolchain 
has other mechanical CAD software. All of those systems must share a common coordinate 
system so that coordinate references are compatible. 

In Pcbnew, it is possible to both customize the coordinate system and to change its origin. 


Grid origin to bottom left 

Repositioning the grid origin to the bottom left of the editor page is a common question by 
people coming to KiCad from other CAD applications. 

Many CAD applications have a coordinate system that originates from the bottom left cor- 
ner of the editor. In Pcbnew, the default origin is at the top left. To change the default origin 
in Pcbnew, open the KiCad preferences window, and click on "Origins & Axes" under "PCB 
Editor." 

You can see the default settings for the Origins & axes below: 


o.0 
Common Display Origin 
Mouse and Touchpad © Page origin 
Hotkeys Drill/place file origin 
Schematic Editor Grid origin 
Display Options 
Editing Options X Axis 
Colors i 
Field Name Templates O Increases right 
PCB Editor Increases left 
Display Options 
Editing Options Ria 
Colors Increases up 
Action Plugins © Increases down 


R 


Figure 13.24.3: The default settings for the Origins & Axes. 
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The default setting, as you see them in the screenshot above, produces a coordinate sys- 
tem with its origin at the top left of the editor. The page origin, in Pcbnew, is always at 
the top left of the editor. To change it to the bottom left, you must first place a grid origin 
marker at the location where you want the new coordinate system to originate and then 
change the display origin to use the new grid origin. 

In Pcbnew, click on the grid origin button from the bottom of the right toolbar: 


re 


Figure 13.24.4: The Grid Origin button. 


Then, create the new origin by clicking at the bottom left corner of the editor: 


FAN Awe 


SE 


Figure 13.24.5: A new grid origin at the bottom left corner of the editor page. 


You now have a new origin. It is not yet enabled, so Pcbnew is still using the default page 
origin. To switch the coordinate system to the new grid origin, open the KiCad Preferences, 
and click on Origins & Axes. Change the Display Origin to "Grid origin" and the Y-Axis to 
"Increases up" (Figure 13.24.3): 
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r 
e e Preferences 
Common Disptay Origin 
Mouse and Touchpad Page origin 
sado Drill/ptace file origi 
B Editor 
Grid origin 
Display Options o = 
Editing Options X Ads 
Colors Oi ‘ 
Action Plugins dile 
Origins & Axes Increases left 


Y Axis 
O increases up 
increases down 


Cancel 


d 


Figure 13.24.3: These settings for the X and Y axes change 


the coordinate origins to the bottom left of the editor. 


Click OK, and return to Pcbnew. Inspect the coordinate system by placing your mouse 
pointer in the new origin (bottom left of the editor page). In the status bar, the X and Y 
value should be zero. Below I show the X and Y values for three positions using the new 
coordinate system. 


x33020 Y 4.0000 


Figure 13.24.6: The coordinates of three positions in the new coordinate system. 


Grid origin anywhere 
In Pcbnew, you can place the grid origin anywhere, not just on a corner of the editor page. 
For example, you can place the grid origin marker in the bottom left corner of a PCB, like 


this: 
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Figure 13.24.7: The grid origin can be anywhere. 


I have retained the settings, as seen in Figure 13.24.7. The coordinates now are all in ref- 
erence to the new origin. 

You can even place the grid origin inside a PCB. This will result in Y coordinates on the left 
side of the central X-axis being negative and positive on the right side. 


Drill/ place file origin 

Pcbnew offers another coordinate system that you can use, the "Drill/place file origin." It 
works in the same way as the grid origin. 

Click on the "Drill/place file origin" button from the right toolbar: 


Figure 13.24.8: The "Drill/place file origin" button. 
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Then, click anywhere in the Pcbnew editor where you want to place the new origin. In the 
example below, I'm setting it near an existing drill origin marker: 


Drill/place 
file origin 


R hid 6 7 
000 O 00 0 Or 


A aoe 


Figure 13.24.9: The "Drill/place file origin" marker next to the Grid origin marker. 


Before the new origin is active, you must select it from the Preferences window. Bring up 
the KiCad Preference window, and click on Origins & Axes. Change the Display Origin to 
"Drill/place file origin," and click OK. 


o Preferences 
Common Display Origin 
Mouse and Touchpad Page origin 
Hotkeys O Drill/place file origin 


Schematic Editor 


Display Options Sra 

Editing Options X Axis 

Colors A 

Field Name Templates O Increases right 
PCB Editor Increases left 

Display Options 

Editing Options ose 

Colors © Increases up 

Action Plugins Increases down 


Figure 13.24.10: The "Drill/place file origin" selected. 


With this, the new origin is on the red marker. My mouse pointer is on the red marker, and 
the X and Y coordinate values confirm this: 
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jjects/MCU Datalogger/MCU Datalogger 2 3.96 X 0.0000 Y 0.0000 dx 73,6600 dy -114.3000 dist 135.9790 


Figure 13.24.11: Testing the "Drill/place file origin" coordinate system. 


When to use an alternate coordinate system? 

In my experience, I have not needed to change the coordinate system in Pcbnew away from 
the default Page origin. This is because all the PCB manufacturers that I have worked with 
have been able to use the default coordinate system, and because I have not had a need 
to work with other CAD applications. 

If you encounter one or both of these cases, Pcbnew provides you with a full set of alterna- 
tive coordinate systems that you can try. 


13.25. KiCad project management with Git 
In this chapter, you will learn how to set up the Git version control system on your computer 
and use it to manage your KiCad projects. 
Git is a free and open-source version control system. With Git, you can create repositories 
of any project that contains text files (and, with some limitations, binary files). A Git repos- 
itory provides you with powerful capabilities that are useful to solo developers and teams. 
Once you commit your project to a Git repository, you will record a complete history of its 
development and explore new features without risking the work you have already done. 
You can also share your work with others and incorporate changes made by team mem- 
bers. You can quickly return to any point in your project's history (no need to keep typing 
Ctr-Z). You can use tags to mark important milestones in your project with a name that is 
easy to remember. 
Once you become familiar with Git and a simple Git + KiCad workflow, you will find it too 
risky to work without Git. 
Why would you want to use Git with KiCad? 
A KiCad consists of several text files. The most important of those files are: 

e The project ".kicad_pro" file. 

e The layout ".kicad_pcb" file. 

e The schematic ".kicad_sch" file. 


All of these files contain simple text. Here's an example of each (only showing a few lines 
for this example): 
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-kicad_pro: 


board Wed 
"design_settings": { 
"defaults": { 
"board_outline_line_width": 0.09999999999999999, 
copper alinea the 0r199999999999999985 
"copper_text_italic": false, 
Weopperatextesnizeshi 1.5). 
copar mee sie ws obio 
copperttextaehickness OS 
"copper_text_upright": false, 
"courtyard_line_width": 0.049999999999999996, 


«Kicad_pcb: 


(kicad_pcb (version 20210623) (generator pcbnew) 


(general 
(thickness 1.6) 


(paper «A4») 

(layers 
(0 «F.Cu» mixed) 
(31 «B.Cu» mixed) 
(32 «B.Adhes» user «B.Adhesive») 
(33 «F.Adhes» user «F.Adhesive») 
(34 «B.Paste» user) 
(35 «F.Paste» user) 
(36 «B.SilkS» user «B.Silkscreen») 
(37 «F.SilkS» user «F.Silkscreen») 


«Kkicad_sch: 


(kicad_sch (version 20210621) (generator eeschema) 


(uuid 6b311d3d-9ael1-4ec9-af71-d4c3a43f0d08) 


(paper «A4») 


(title_block 
(title «A 4x8x8 LED Matrix Display Clock») 
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(date «2021-07-14») 
(rev «${design_version}») 


(Lib_symbols 
(symbol «ArduinoProMiniSimple:ArduinoProMiniSimple» (in_bom yes) (on_board 
yes) 


KiCad's projects are composed of text files, making it easy to use a versioning system like 
Git to track of all changes made across the project. There are several popular versioning 
systems available, but my personal preference is Git. It is open-source, fast, widely used, 
and highly versatile. As you will see in this recipe, it is also straightforward to use. 

What you will learn in this recipe is how to use Git, and the Github online repository, to 
maintain your project's history. Doing so will allow you to: 

1. Preserve your project's history. This will allow you to access past versions of any 
file in your project. 

2. Create experimental branches. This is useful if you want to experiment with alter- 
nate design options or design different versions of the same board. Each one can 
be stored in a separate branch of the same repository. 

3. Merge or discard different branches. This Git function allows you to merge (unify) 
two branches into one. For example, you may have the main branch of your pro- 
ject and work on an experimental branch as you are investigating a special board 
feature. If the experiment succeeds, you can merge the experimental branch to the 
main branch and continue there. If not, you can just discard the failed experiment 
branch and continue with the intact project in the main branch. 


These are just three of the many possible scenarios. Those are the three scenarios that I 
use most often. 

Using Git alongside an online repository, like Github**, you will use this versioning system 
to collaborate with other people on the same project. You will also be able to share your 
project and its history with other people. 

In Figure 13.25.1, you can see part of the most recent history’? of one of the projects in this 
book, as it appears in the publicly accessible repository on Github. 


24 https://github.com/ 
25 https://github.com/futureshocked/MCU_datalogger_kicad/commits/main 
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A futureshocked / MCU_datalogger_kicad 


<> Code © Issues I") Pullrequests © Actions 


P main- 
<> Commits on Jul 29, 2021 


Backlink to CADLAB.io has been added. 
e futureshocked commited on 29 Ju 


(9 tuturoshockod committad on 29 Jus 


Added README. 
@ tutureshocked committed on 29 Jus 


Create README.md 
e futureshocked committed on 29 Jut 


© Commits on Jul 23, 2021 


Added dsn files in the ignore list. 
@ tutureshocked committed on 23 414 


© Commits on Jul 22, 2021 


Added gitattributes file to preven PCB files from merge. 
(9 tutureshocked committed on 22 Jul 


Merge branch 'main' of https: //atthub.com/tutureshocked/MCU_datalogge... 


Q Notifications 


E] Projects 0O wiki 


Tr Star 


1 


© Security 


[=] 


2303739 


5dè7859 


2880299 


83c8c88 


bSabSe4 


32c16f8 


Y Fork 


© 


o 


0 


Figure 13.25.1: One of my KiCad projects on Github, showing the recent project history. 


In Figure 13.25.2, you can see the history of the schematic file”? for the same project. 


E futureshocked / MCU_datalogger_kicad 


<> Code © issues 1% Pull requests 


History for MCU_datalogger_kicad / MCU Datalogger.kicad_sch 


< Commits on Jul 22, 2021 


Made small change to schematic. 
a futureshocked commtied on 22 Jul 


Completed 2-layer PCB, 
(9 futureshocked comenitied on 22 Jul 


Fixed outstanding issues. 
@ tutureshocked committed on 22 Jul 


© Commits on Jul 20, 202% 


Completed comments. 
(9 tuturesnocked commitied on 21 Jul 


Completed wiring in the second sheet. 
@ futureshocked committed on 21 Jul 


Completed wiring of main sheet. 
@ tuturesnocied committed on 21 Jul 


Completed symbol-footprint associations, 


Q Notitications 


© Actions El Projects CO wiki 


e 


YY sur 


© Security 


7esBd78 


a69laée 


1773817 


Bfdiab7 


AfaeBón 


2039203 


d52702e 


1 


Y Fork 


<> 


<> 


<> 


<> 


<> 


L 


e futureshocked committed on 27 Jul 


Figure 13.25.2: Part of the history of the schematic file on Github. 


26 https://github.com/futureshocked/MCU_datalogger_kicad/commits/main/ 
MCU%20Datalogger.kicad_sch 
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The numbers on the right side of each column are called 'commits.' Each number is an ID 
that refers to a commit. The full ID of a commit is a long alphanumeric, like '7e48d7843cbe- 
041f04e2126f5f75c9c94cafce23'. What you see in Figure 13.25.2 is a short hash of that ID. 
A commit may contain changes in multiple files or additions and removals of files. To get 
detailed information about a commit, you can click on the commit number. The result is a 
side-by-side comparison of the changes detected in each file, as in the example of Figure 
1325.3: 


Made small change to schematic. Browse files 
P main 


@ futureshocked committed on 22 Jul 1 parent ecf6978 commit 7e48d7843cbe041f04e2126f5f75c9094cafce23 


Showing 1 changed file with 4 additions and O deletions. Unified Split 


v “6 mema MCU Datalogger.kicad_sch (0) 


ad, EE -1348,6 +1348,18 60 
1348 1348 (effects (font (size 1.27 1.27)) (justify right bottom) ) 
1349 1349 (uuid ec5d4951-a185-4f48-b810-e3abc3aacfd2) 
1350 1350 ) 


1351 
1362 


{label *Abc123" (at 173.99 34.29 0) 
(effects (font (size 1.27 1.27)) (justify left bottam)) 
1363 (uuid 35adadb2-a852-4d83-a913-b47252416313) 
1354 } 
1351 1355 (label "Vcc" (at 179.07 83.82 180) 
1352 1356 (effects (font (size 1.27 1.27)) (justify right bottom) ) 
(uuid 43d8cc99-b069-4284-9d3d-9c338dc6e99f) 


E ee 


Ocomments on commit 7e48d78 


Figure 13.25.3: The changes in this commit of file "MCU Datalogger.kicad_sch". 


In this chapter, I will give you a brief introduction to Git and Github. Git is a big topic, 
and I encourage you to learn more about it by using a specialized source like this Getting 
Started” guide from Github. You may also consider our comprehensive course?! on the Tech 
Explorations website. 
Read on to learn how to use Git and Github in the context of a KiCad project. You will learn 
how to: 
1. Install and configure Git on your computer. 
Create a new Git repository for your KiCad project. 
How to exclude files that you do not want to track in Git. 
Commit changes to your project to the repository. 
See those changes in the log. 
Checkout past commits. 
Create branches. 
How to merge branches. 
How to prevent the merging of specific files from different branches. 
10. Upload your project to Github so you can share it with other people. 


OP ONANARWN 


27 https://guides.github.com/activities/hello-world/ 
28 https://techexplorations.com/so/git-and-github/ 
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13.25.1. Install Git 

Git has installers for MacOS, Windows, and Linux. 

You can download the installed for your operating system at https://git-scm.com/downloads 
(Figure 13.25.1.4). 


. 
® git —fast-version-control Q Sears 
About 
a Downloads 
Downloads Latest souree Release 
GUL Cheats 2.33.0 
Logos nacos RF Windows bel a j 
Community À Linux/Unix 


Older releuses are available and the Git source 


repository ia on GitHub. 
he estira Pro Git book 
watun by Sort Chana anid 
Ben Straub de avatlvhheto reed 
online for free. Dwad trne 


versiota ane available on GUI Clients Logos 
Atmeaaunn com, 
Dit comes with built-in QUI tools (git-gui, Variona Git lagos in PNG (bitmap) and KPS 
pith), but there ane several third-party tools for (vector) formats are available for use in online 
users luokling far 1 platform-spucitie and print profecia. 
parana. 
View Logos — 


View GUI Clients — 


Git via Git 
Ifyou alrvody have Git installed, you can yet the hates: development version via Git itself: 


git clone bttps://github.com/git/git 
You can also always browse the current contents of the git repository asing the web interface. 


About this sito Ge x a ember et Software #reedom Conservancy 
Pante miz amt enie are weie 


Figure 13.25.1.4: The download page for the Git installer. 


The installation process is easy. I suggest you use the binary installer for your OS instead 
of trying to compile from the source. 


You can also find clear installation instructions and the binary installer downloads: 


1. MacOS”, 
2. Windows®. 
3. LIMPE! 


Go ahead and install Git on your computer. After installing Git, continue to the next seg- 
ment, showing you how to configure it. 


13.25.2. Git configuration 

Now that you have installed Git on your computer, you need to do some simple configura- 
tions before using it. Git works best when it knows who you are (¡.e., your user name) and 
your email address. It will use this information to attribute operations such as commits and 
deletes to the user that has performed them. 


29 https://git-scm.com/download/mac 
30 https://git-scm.com/download/win 
31 https://git-scm.com/download/linux 
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Bring up a terminal window. 
At the command prompt, configure your git user settings: 


$ git config --global user.name 'testuser' 

$ git config --global user.email 'testuser@example.com' 

$ git config —--global init.defaultBranch main 

$ git config —-global credential.helper "cache —-timeout=86400" 


Below you can see my configuration session on a terminal window in MacOS (Figure 
13.25.2.5): 


Figure 13.25.2.5: My Git configuration session. 


By default, the main branch of Git is called "master." In recent years there has been a 
change in the traditional terms "master" and "slave" across computer science disciplines 
and systems. Github, as an example, has changed its default Git branch from "master" to 
"main." This is why in my Git configuration session above, I have used the "init.default- 
Branch" option to set "main" as the name of the main branch. This way, the main branch 
name on my computer will be the same as on Github. 

The last configuration where I use the "credential.helper" option sets Git to cache my 
Github credentials so that I don't have to authenticate each time I interact with Github on 
the command line. 

You can find details about all the available configuration options in the documentation’. 
That's it; the configuration is complete. Let's continue to the next segment, where we'll 
create a new Git repository for a simple demonstration KiCad project. 


13.25.3. Create a new KiCad project Git repository 

Git is now ready to help manage a new (or existing) KiCad project. . I'll show you how to 
create a new repository, do the first few commits, and check the repository status in this 
segment. 

To demonstrate, I will use a small KiCad demonstration project from earlier in this book. 
The project contains a small number of files, as you can see in Figure 13.25.3.6: 
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ink Pre = 
Name Size Kind 
> DD Blank Project 2-backups Folder 
{IB Blank Project 2.kicad_pcb 2KB pebnew board 
Blank Project 2.kicad_pri 1KB Document 
[Ki] Blank Project 2.kicad_pro 9KB kicad project files 
g Blank Project 2.kicad_sch 13KB eesche...ocument 
fp-info-cache 3.1 MB Document 
fp-lib-table 144 bytes Document 
~ EJ Libraries — Folder 
v Ez 3D -- Folder 
MSC1212Y5PAGT.step 22MB Document 
v EJ Project_ABC_Footprints Folder 
OFPS0P1200X1200X120-64N.kicad_mod 7KB Document 
v DD Symbols -- Folder 
MSC1212Y5PAGT.lib 3KB Document 
sym-lib-table 140 bytes Document 


Figure 13.25.3.6: I'll create a Git repository on this KiCad project. 


This project has a schematic that contains a few resistors and capacitors. It is very simple, 
and for this reason appropriate to demonstrate how to use KiCad to track changes between 
commits (Figure 13.25.3.7). 


Project name: 


R1 R2 R3 R4 R5 R? 
100R 200R 300R 400R 500R R 


p 


Loa de 2 Udo Su. ER 
T aad g iii oi a E sai y 50u 


Figure 13.25.3.7: The project schematic before the first commit. 


The layout editor is blank. 
Start by bringing up the terminal. To confirm that there is no Git repository setup yet, use 
the "status?" command (Figure 13.25.3.8): 


% git status 
Fatal: not a git repository (or any of the parent directories): .git 
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Figure 13.25.3.8: The "git status" command and its output. 


The "status" command complained about the absence of the ".git" repository. Git keeps all 
repository data and configuration inside a directory named ".git," and the absence of this 
directory indicates that there is no Git repository present (Figure 13.25.3.9). 

Let's create a new repository. The command is "init": 


% git init 
Initialized empty Git repository in /Users/peter/Documents/Kicad/Course 
development documents/KiCad 6 test projects/Blank Project 2/.git/ 


Figure 13.25.3.9: Created a new Git repository. 


In the screenshot above, you can see that the ".git" is now present. This means that the 
KiCad project directory now contains a Git repository. The repository is empty, as you can 
confirm by using the "status" command once again (Figure 13.25.3.10): 
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% git status 
On branch master 


No commits yet 


Untracked files: 
(use «git add <file>..." to include in what will be committed) 

.DS_Store 
Blank Project Z—backups/ 
Blank Project Z.kicad_pcb 
Blank Project Z.kicad_prl 
Blank Project Z.kicad_pro 
Blank Project Z.kicad_sch 
Libraries/ 
fp-info-cache 
fp-lib-table 
sym-lib-table E 


nothing added to commit but untracked files present (use «git add» to track) 


fil 
"git add <f e> " to include in what will be committed) 


nothing added to commit but untracked files pr e "git add” to track) 


Figure 13.25.3.10: No commits, several un-tracked files. 


The response from the "status" command is that there are no commits to the repository 
and several files in the working directory that are not being tracked. Git even suggests that 
I use the "add" command to start tracking these files. 

I'll show you how to do this soon, but first, I want to show you how to not track (or ignore") 
files that are not necessary. Ignoring such files keeps the repository tidy. An example of 
such file is ".DS_Store", which is created by MacOS and is not a project file. Ignoring this 
file is advisable. I'll show you how in the next segment. 
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13.25.4. How to ignore files 

Not all files that are present in a project repository should be tracked. In the previous seg- 
ment, I created a new Git repository for my simple KiCad project. One of the files in the 
project repository is ".DS_Store", which is a MacOS system file. I want to exclude this file 
since it is not relevant to the project. It will also benefit my project collaborators who might 
be working on Linux or Windows computers. 

To instruct Git to ignore one or more files, or even a full directory, create a new file named 
" gitignore**",. Use any text editor for this. Below you can see the contents of my ".gitignore" 
file: 


*.xml 

*.dsn 
.DS_Store 
Fp-info-cache 
*xGerber/x 


*xbackups/* 


In my .gitignore file, I am excluding several other files and directories in addition to the 
"DS_Store" file. I use wild-card characters like "*" to match multiple files. For example, 
I am ignoring all files with extensions ".xml" and ".dsn", and all files insider any directory 
that contains the string "Gerber". 

You can learn more about the syntax used in gitignore files in the Git documentation”. 
Save this file, and the try the "status" command once again. Here is the new output: 


% git status 
On branch master 


No commits yet 


Untracked files: 
(use «git add <file>...» to include in what will be committed) 

-gitignore 
Blank Project Z.kicad_pcb 
Blank Project Z.kicad_prl 
Blank Project 2.kicad_pro 
Blank Project Z.kicad_sch 
Libraries/ 
Fp-lib=table 
sym-lib=table 

nothing added to commit but untracked files present (use «git add» to track) 


% 


As you can see, the ".DS_Store" file is not included in the listing of untracked files. It is 
now ignored. 


34 https://git-scm.com/docs/gitignore 
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It is time to do the first commit, and I'll show you how in the next segment. 


13.25.5. Basic Git commands: add, commit 

I have configured Git, created a new repository, and set the gitignore file. It is time to do 
the first commit for this demo KiCad project. 

Remember that the last time I issued the "status" command, Git indicated that several 
files are untracked. Git will only commit tracked files. Therefore, before I commit, I must 
instruct Git to track one or more files. 

The command for this is "add”*", as in "add a file(s) to the repository and begin tracking 


them." For the first commit, I can use the "." operator with the "add" command so that Git 
will start tracking all non-ignored files. Here is my session: 


% git add. 


% 


That's it. I'll use "status" once again to see the changes (Figure 13.25.5.11): 


% git add. 
% git status 
On branch master 


No commits yet 


Changes to be committed: 
(use «git rm --cached <File>...» to unstage) 
new File: .gitignore 
new File: Blank Project 2 kicad_pcb 
new File: Blank Project Z.kicad_prl 
new File: Blank Project 2 kicad_pro 
new File: Blank Project Z.kicad_sch 
new File: Libraries/3D/MSC121ZY5PAGT step 
new File: Libraries/Project_ABC_Footprints/QFP50P1200X1208X120-64N. 
kicad_mod 
new File: Libraries/Symbols/MSCLZLZYSPAGT. lib 
new File: Fp—lib—-table 
new File: sym-lib-table 
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Blank Pro 


Figure 13.25.5.11: No commits, several tracked files. 


The status command reports that several files are now being tracked but not committed. 
Notice that Git shows the tracked files in green. In Figure 13.25.5.10, untracked files are 
in red. 

Files that are tracked but not committed can change, but Git will not capture the changes 
in the repository until the files are committed. 

To commit a file (or files) to the repository, use the "commit?" command. This command 
can receive various modifiers and parameters. In most cases, you will want to use the 
"-am" flags. With "a," you tell Git to commit all files that are waiting in the index (that is, 
being tracked). With "m," you can include a commit message in the same command (oth- 
erwise, Git will open a text editor and ask for one). 

Here is the first commit command for this repository: 


% git commit —am "First commit." 

[master (root-commit) 16a0e89] First commit. 

10 Files changed, 30490 insertions(+) 

create mode 100644 .gitignore 

create mode 100644 Blank Project 2.kicad_pcb 

create mode 100644 Blank Project Z.kicad_prl 

create mode 100644 Blank Project Z.kicad_pro 

create mode 100644 Blank Project Z.kicad_sch 

create mode 100644 Libraries/3D/MSC1212Y5PAGT.step 
create mode 100644 Libraries/Project_ABC_Footprints/QFPSOP1200X1Z00X1Z0-64N. 
kicad_mod 

create mode 100644 Libraries/Symbols/MSC1212Y5PAGT.lib 
create mode 100644 Fp-lib-table 

create mode 100644 sym-—lib-table 


% 
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The commit command response confirms that ten files were committed into the master 
branch, and the hash of the commit ID is 16a0e89. 
I'll do another "git status" to see the current status of my repository: 


% git status 
On branch master 
nothing to commit, working tree clean 


My repository tree is clean, and there are no changes to commit. 

One thing that bothers me is that the name of the only branch that exists in my new re- 
pository is "master." As I mentioned earlier in this chapter, there is a recent trend to use 
"main" instead of "master" in IT and computer science. So, before I continue, I will rename 
my existing "master" branch into "main." 

The command for this is "branch**". If you issue "git branch" without any parameters, Git 
will give you a listing of branches in the repository. Then, you can use the "-m" switch to 
rename a branch. 

Here are the relevant commands for the above: 


% git branch 
* master 


% git branch -m master main 
% git branch 


* main 


Another command that I use frequently is "log." With the log command, you can see the 
recent history of your project. Try it now: 


% git log 

commit 16a0e89fc22f74dad95F4f20eccdee8le583e084 (m -> main) 
Author: peter <peter@txplore.com> 

Date: Tue Jul 27 08:53:18 2021 +1000 

First commit. 


% 


The log command responds with a list of commits, their IDs, author and date information, 
plus the commit message. I have only done a single commit in this example, so the re- 
sponse contains a single record. 
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Let's make a small change to the schematic to learn how to deal with change. Open the 
schematic, and add a new resistor (Figure 13.25.5.12): 


Project name; 


R1 R2 R3 R4 R5 R7 
100R 200R 300R 400R 500R R 


i_ e E a Lo Bid 08 
vá nad i Sa E > sai. 50u 


Figure 13.25.5.12: I have added a new resistor (R5) to the schematic. 


Save the schematic file. Back in the command line, use the "status" command to see if Git 
has detected the change: 


% git status 
On branch main 
Changes not staged for commit: 
(use "git add <file>..." to update what will be committed) 
(use "git checkout -- <file>..." to discard changes in working directory) 
modified: Blank Project Z.kicad_sch 
no changes added to commit (use "git add" and/or "git commit -a") 


% 


Yes, of course, it did. Git has detected a change in "Blank Project Z.kicad_sch." 
You can see the exact changes with the "git diff?"" command (Figure 13.25.5.13): 


% git diff 


39 https://git-scm.com/docs/git-diff 


e 327 


KiCad Like a Pro, Projects, Tips and Recipes 


index df93dce..100d4e1l 100644 
--- a/Blank Project 2.kicad_s 
+++ b/Blank Project 2.kicad_sch 


AR - 


Figure 13.25.5.13: "Git diff" shows the current changes. 


The "diff" command will show the new content in green and removed content in red. 
I will proceed with the new commit: 


% git commit —am "Added a resistor." 

[main 7e4bf0e] Added a resistor. 

1 file changed, 24 insertions(+), Z deletions(-) 
peter@Peters—iMac Blank Project 2 % git status 
On branch main 
nothing to commit, working tree clean 


% 


The hash from the new commit ID is 7e4bf0e. You can use this hash later to checkout a 
specific commit. Your repository now contains two commits. 

Imagine that you would like to experiment with your design. It may not work out, and you 
may need to retract to the current state of the project. To do this safely, you can create a 
new Git branch and do the necessary work there. In the next segment, I'll show you how 
to work with branches. 
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13.25.6. Basic Git commands: branch 

In Git convention, the "main" or "master" branch contains the "official" state of the project. 
This may be the project instance you want to share with others, publish on your website, 
compile for production, or send to the PCB manufacturer. Work that involves, for example, 
adding new features, experimenting, or testing, is typically done in dedicated branches. 
For example, in my KiCad projects, I often maintain a main branch with the PCB that I am 
comfortable sharing with students and other branches to experiment with different layout 
configurations or components. In one of the projects in this course, I maintain separate 
branches for the 2-layer and 4-layer versions of the same board. 

In this segment of the chapter, I will show you how to work with branches. 

To create a new branch, use the "checkout*" command with the "-b" switch and a name 
to create a new branch. The "-b" switch will cause the creation of a new branch. If you 
use "checkout" without "-b," Git will attempt to checkout (i.e., make active) the specified 
branch. 

Here is the command and the response: 


% git checkout -b experimental 
Switched to a new branch 'experimental' 


% 


You can verify that the new branch exists using the "branch" command: 


% git branch 
* experimental 


main 


In the output above, notice the "*" in front of the "experimental" branch? This indicates 
that the starred branch is active, and any new commits will go into this branch. 


The new branch has inherited all content from the previously active branch, "main." You 
can look at the content of the schematic editor, and you will see that it is identical to its 
content under the main branch. 


I will introduce a change: a new capacitor, "C6". The new schematic looks like this (Figure 
13.25.6.14): 
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Project name: 
R6 R1 R2 R3 R4 R5 R7 
500R 100R 200R 300R 400R 500R R 


L cs Lando llo. .Llo.lco 
p 10u mT” eT rT SUT wT 50u 


Figure 13.25.6.14: While working in the "experimental" branch, I changed the schematic. 
Save the schematic editor, and return to the terminal. Get the new status of the project: 


% git status 
On branch experimental 
Changes not staged for commit: 
(use "git add <file>..." to update what will be committed) 
(use "git checkout — <File>..." to discard changes in working directory) 


modified: Blank Project 2.kicad_sch 


no changes added to commit (use «git add» and/or «git commit -a») 


% 


Git responds with the name of the current branch ("experimental") and the file's name 
where the change is detected. Let's commit this change with the "commit" command: 


% git commit -am "Added capacitor." 
[experimental d389140] Added capacitor. 


1 File changed, 22 insertions(+) 


% 


Git confirms that it has committed one new file to the "experimental" branch. The commit 
contained 22 new lines, and the first seven characters of the commit ID are d389140. 


Also, try a "git log" (Figure 13.25.6.15): 
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iMac Blank 
HEAD 

e te m +<xp 

Jul 09:01 


capacitor. 


Author: 


Date: 


Figure 13.25.6.15: Git log showing the recent repository history. 


The "git log" reports the full commit IDs. Notice the complete commit ID of the latest com- 
mit (the first in the list) and how the first seven characters of the ID match those reported 


by the commit command ("d389140"). 


Say that you would like to go back to the main branch. You can checkout to the latest com- 
mit of the main branch without this affecting any work you have done in the experimental 
branch. To checkout to the HEAD (i.e., the newest commit) of a branch, use the "checkout" 


command: 


% git checkout main 
Switched to branch 'main' 


Now, use "git log" to see the status of the repository in the main branch: 


% git log 

commit 7e4bf0elbec1624f08743d6f4660c4daedfSS7d (HEAD -> main) 
Author: peter <peter@txplore.com> 

Date: Tue Jul 27 08:59:32 2021 +1000 


Added a resistor. 
commit 1600e89fc22F74dad95f4f20eccdee8le583e084 
Author: peter <peter@txplore.com> 


Date: Tue Jul 27 08:53:18 2021 +1000 


First commit. 
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As you can see, in the main branch, the new capacitor does not exist. I created the capac- 
itor while working in the experimental branch, and I committed this change there. 


Now, assume that you are happy with the change in the experimental branch, and you 
would like to "import" this change into the main working branch. To do this, you will use the 
"merge" command. I'll show you how in the next segment of this chapter. 


13.25.7. Basic Git commands: merge 

In the previous segment of this chapter, you created an experimental branch and made a 
change to it. Now, you want to import this change to the main working branch. The git term 
for this operation is "merge." Effectively, you want to merge one branch into another. To do 
this, you will use the "merge**" command. 


Start by confirming that you are currently working in the main branch (which is where you 
want to merge into): 


$ git branch 
experimental 


*x main 


The star next to "main" indicates that you are working in the main branch. 
Do the merge: 


% git merge experimental 

Updating 7e4bf0e..d389140 

Fast-forward 

Blank Project Z.kicad_sch | 22 ++++++++++++++++++++++ 
1 file changed, 22 insertions(+) 


% 


The merge response provides information about what just happened. One file in the main 
branch was changed, and 22 new lines were inserted. The file that was changed is "Blank 
Project Z.kicad_sch." 


The "merge" command is very flexible. You can use it to merge not only a branch into an- 
other branch but also a specific commit into a branch, using the commit ID. In most cases, 
using branch names, as in the example above, is sufficient. 


The line starting with "Updating" tells you that changes from commit ID "d389140" were 
merged into commit ID "7e4bf0e". 


Note that the merge operation does not overwrite contents. It merges contents. There is 
a lot of intelligence embedded into Git to ensure that work is not lost. If Git cannot figure 
out how to do a merge, it will ask you to clarify. Merge conflicts happen when, for example, 


41 https://git-scm.com/docs/git-merge 


e 332 


Part 13: Recipes 


the same lines in a file are changed in both the source and the destination conflict. In such 
cases, Git will not change anything and ask you to resolve a conflict manually. 

With the merge completed, let's verify that the capacitor I added in the experimental 
branch now exists in the main branch. Open Eeschema, and look at the current state of the 
schematic (Figure 13.25.7.16): 


Project name: 


Ri R2 R3 R4 R5 R7 
100R 200R 300R 400R 500R R 
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Figure 13.25.7.16: The new capacitor exists in the main branch. 


500R 


The new capacitor exists in the main branch. You can also use the "log" command to get 
the recent repository history: 


% git log 

commit d389140b627c4e76219a337d1dc022f8fbd36244 (HEAD -> main, experimental) 
Author: peter <peter@txplore.com> 

Date: Tue Jul 27 09:01:27 2021 +1000 


Added capacitor. 


commit 7e4bf0e1fb2c1624f08743d6f4660c4daeaf557a 
Author: peter <peter@txplore.com> 
Date: Tue Jul 27 08:59:32 2021 +1000 


Added a resistor. 


commit 16a0e89fc22F74dad95f4f20eccdee8le583e084 
Author: peter <peter@txplore.com> 
Date: Tue Jul 27 08:53:18 2021 +1000 


First commit. 


% 


As you can see from the output above, commit d389140 exists in both the main and the 
experimental branches. 
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Now that the changes in the experimental branch are merged with "main," we no longer 
need the experimental branch. It is good practice to delete unneeded branches and keep 
the Git repository tidy. To delete a branch, use the "branch" command with the "-d" switch, 
like this: 


% git branch -d experimental 
Deleted branch experimental (was d389140). 
% 


Repeat the "git branch" command to confirm that the repository contains only the main 
branch. 


If the branch that you want to delete contains unmarked changes, but you are sure that 
you do want to delete it, you can use the "-D" switch (instead of "-d"). This will force Git 
to delete a branch with unmarked changes. Without it, Git will ask you for confirmation. 
Remember: Git is designed to minimize the risk of losing work. If you try to do something 
that can result in lost work, Git will let you know and prevent you from losing work. 


13.26. Sharing your KiCad project on GitHub 
Suppose you would like to publish your project online so that other people can access it. 
You can do this easily by creating a remote Git repository on a cloud service like Github. The 
repository on Github is a remote copy of your local repository. When you make a change to 
your local repository, you can push it to the remote so that your collaborators can access 
the updates. And vice-versa: if a change is accepted in the remote, you can pull it to your 
local repository so that you can use the changes. 
In this chapter, you will learn how you can use Github to share your existing KiCad project 
with others. The project I will be using to demonstrate the process is the one I also used in 
the chapter "13.25. KiCad project management with Git". 
The process has four steps: 

1. Create a remote repository on Github. 

2. Set the origin. 

3. Sync the remote repository with your local Git repository. 

4. Share Github repository with others. 


Let's begin. 
1. Create a remote repository on Github 


Start by creating a free account on Github if you don't already have one. 
Then, login and create a new blank Github repository (Figure 13.26.1) : 
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% Git - Downloads 


New repasitor 
lew repository 


Import repository 


Explore 
New gist 
kitesurfe a 
ws2e12 New organization P8266 


AS Oc. New project 
vy Star 


CppCon/CppCon2017 


Slides and other materials from CppCon 2017 
O pyinon Ér 16k 


|[Sensing 7 days ago 


CppCon/CppCon2018 
Slides and athar materials from CppCon 2018 
pressive_Sensing 
O c+. Y713k 
Ly Star 


Figure 13.26.1: Create a new blank repository on Github. 


Give it a name, a description, and an access type. I have set my demo repository to "Pub- 
lic." There are a few optional settings that you can enable, such as the addition of a READ- 
ME or ".gitignore" files (Figure 13.26.2): 


Pull requests Issues Marketplace Explore 


Create a new repository 
A repository contains all project files, including the revision history. Already have a project repository 
elsewhere? import a repository, 


Owner * Repository name * 
(9 futuroshocked» / | blank_project Y 
Great repository names are sh biank_project is available. | inspiration? How about congenial-spork? 


Description (optional) 


o Public 
A Anyone on the internet can see this repository. You choose who can commit. 
Private 
You choose who can see and commit to this repository. 


Initialize this repository with: 


Skip this step if you're importing an existing repository 


Add a README file 


This is where you can write a long description for your project. Learn more. 


Add .gitignore 


Figure 13.26.2: Create a new repository on Github. 


Click on the green "Create repository" button to finish this step. 
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2. Set origin 

When Github completes creating the new repository, it will show you a page containing 
information that you will need in the next few steps. Copy this information in a text editor 
so that you can use it later. Most important is the HTTPS and SSH address of your Github 
repository that appears at the top of the page ("1" in Figure 13.26.3): 


Quick setup — if you've done this 


[O Set up in Desktop or res | ss 


ICENSE, and .gitignore, 


„Or create a new repository on the command line 


echo "* blank_project_2* >> REAOME.md 6 
git init 

git add README md 

git commit -a "first commit" 

git branch -M main 

git remote add origin https://github.cam/futureshocked/blank_project_2.git 

git push <u origin main 


pository from the command line 


git remote add origin httos://github.com/futureshocked/blank_project_2.git eo 


git branch -4 main 
git push -u origin main 


Figure 13.26.3: The URL of the new repository. 


The same page contains instructions on setting the "origin" repository for your local Git 
repository. The name "origin" simply represents the remote repository of your local Git 
repository that (in our example) is hosted on Github. You may choose a different name if 
you wish, like "GitHub" or "cloud," however, remember that convention uses "origin" for the 
primary remote repository. 

Also, notice at the bottom of the Github instructions in Figure 13.26.3 the commands 
Github suggests referring to the "main" branch. This means that we will be syncing the 
"main" branch first. If your local repository contains additional branches that you wish to 
"push" to Github, you can do this subsequently. You can choose to push specific branches 
only. 

Next, go to your command line, and browse to the directory where you saved your project. 
Copy the first line of the Github instructions ("2" in Figure 13.26.3): 
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Figure 13.26.4: Setting the origin. 


When you set the origin ("1" in Figure 13.26.4), Git will record the origin URL in the config 
file inside the ".git" folder. You can confirm this by using the "cat" command on the config 
file (or simply open config in a text editor). See "2" in Figure 13.26.4. 

Github also recommends that you use "git branch -M main" to switch the name of the 
unborn branch to "main." This is unnecessary because I have already created the "main" 
branch in this repository. You can still issue this command, but it will not change anything. 
Let's continue with step 3. 


3. Sync the remote repository with your local Git repository. 

I will now push the "main" branch of my local repository to Github. To do this, I will use the 
3rd command from Figure 13.26.4. This requires setting up a new personal access token 
that you can use in place of your regular account password. 

To create a personal access token (refer to Figure 13.26.5), go to Github, click on your ac- 
count photo (top right of the Github page), then Settings (1), and Developer settings (2). 
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Giwnseist Yrs Yw: Your stars OS ‘Twitter username 
Your gists 
Saved replies 
TE-Arduino-SbS-Getting-Serious fi . Company 
Y ‘ature proviow Š m 
Toch Explorations 
You can @mantion your companys an 
Developer setting X 
Maderatinn settinns sce 
e xer HTTPS, OF can Be uted 1o sumare sts to the 44% ouw Bate Autentica 
Expiration * 
zess the GitHub API. 
Lant used within the iest 2 weeks Delete 
3 Last used within the leat 2weeks Delete 


Figure 13.26.5: Generate a new personal access token. 


Click on Personal access tokens in the Developer Settings page and then "Generate new 
token" (3). Give your new token a name, and select all radio buttons in the "repo" group 
(4). Click on the green "Generate token" button to finish the process. 

You now have a new personal access token (Figure 13.26.6): 


Personal access tokens Generate new token Revoke all 
Tokens you have generated that can be used to access the GitHub API. 
Make sure to copy your personal access token now. You won't be able to see it again! 
Y ghp_cDvKtcfDPHfq70jVAxgxyBhhnulgvF1LQ2Db {E Delete 
Cloud9 editor 2 — repo Last used within the last 2 weeks Delete 
A This token has no expiration date. 
Cloud9 — repo Last used within the last 2 weeks Delete 


Figure 13.26.6: The new personal access token. 


Continue at the command line. Copy command 4 from Figure 13.26.3: 


% git push -u origin main 


Github will ask for your username and password. Type or copy your username (or email). 
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For the password, use the personal access token that you created earlier (Figure 13.26.6) 
Git will proceed to write "main" branch data to origin (i.e. to the remote repository): 


peter@Peters-iMac Blank Project 2 % git push -u origin main 
Username for 'https://github.com': futureshocked 

Password for 'https://futureshockedegithub.com' : 
Enumerating objects: 22, done. 

Counting objects: 100% (22/22), done. 

Delta compression using up to 16 threads 

Compressing objects: 100% (20/20), done. 


Writing objects: 100% (22/22), 334.88 KiB | 7.13 MiB/s, done. 
Total 22 (delta 4), reused Q (delta 0) 

remote: Resolving deltas: 100% (4/4), done. 

To https://github.com/futureshocked/blank_project_2.git 

* [new branch] main -> main 

Branch 'main' set up to track remote branch 'main' from 'origin 
peter@Peters-iMac Blank Project 2 % 


Figure 13.26.6: Synced "main" branch. 


Your project ("main" branch of the repository) is now on Github. Refresh the project page 
to confirm: 


E futureshocked / blank_project_2 © Urvevat 
<> Code Issues Pull requests Actions Projects Wiki Security Insights El 
F main + P 1bra DO tag Go to file Add file ~ $ Code ~ 
e futureshocked Added capacitor. 4389140 24 minutes ago © 3 commits 


Libraries First comr 


gitignore First commit 32 minute 
Blank Project Z.kicad_pcb First commit 2 minut 
Blank Project 2.kicad_prl First commit inutes ago 


Blank Project 2.kicad_pro First commit 32 minute 


Blank Project Z.kicad_sch Added capacito 24 minute 

fp-lib-table First commit 32 minute 

sym-tib-table First commit 2 minutes 
Help people interested in this repository understand your project by adding a README. 


Figure 13.26.7: The KiCad project, "main" branch, on Github. 
Take a moment to browse the files and look at their contents. 
Now, say that you want to do some work on the local branch. For example, you'd like to 
create a new branch to do some experimental work. As you already know, you can create 
a new branch like this: 


% git checkout -b experimental2 


Then, go to the schematic and make a small change, like add a new resistor. Save the 
schematic. 
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Back on the command line, commit the change, and look at the repository status: 


% git checkout -b experimental2 
Switched to a new branch 'experimental2' 
peter@Peters—iMac Blank Project % git branch 
* experimental2 
main 
% git status 
On branch experimental2 
Changes not staged for commit: 
(use "git add <file>..." to update what will be committed) 
(use "git checkout — <file>..." to discard changes in working directory) 


modified: Blank Project 2 kicad_sch 


no changes added to commit (use «git add» and/or «git commit -a») 

% git commit -am "Added R8." 

[experimentalZ @bfaeSZ] Added R8. 

1 file changed, 22 insertions(+) 

% git status 

On branch experimentalZ 

nothing to commit, working tree clean 
The new branch ("experimental2") contains a change I'd like to push to Github. Branch 
"experimental2" does not exist on Github. To create the new branch and push its changes 
from local to "origin," I'll use this command: 


% git push —u origin experimental2 

Enumerating objects: 9, done. I 

Counting objects: 100% (9/9), done. 

Delta compression using up to 16 threads 

Compressing objects: 100% (7/7), done. 

Writing objects: 100% (7/7), 1.01 KiB | 1.01 MiB/s, done. 

Total 7 (delta 4), reused 0 (delta 0) 

remote: Resolving deltas: 100% (4/4), completed with 2 local objects. 
remote: 

remote: Create a pull request for 'experimental2' on GitHub by visiting: 
remote: https://github.com/futureshocked/blank_project_2/pull/new/experimental2 
remote: 

To https://github.com/tutureshocked/blank_project_2.git 

x [new branch] experimental2 —> experimental2 

Branch 'experimental2' set up to track remote branch 'experimental2' From 
Olen Cell ie 


% 
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Git did not ask for my credentials again because I have configured it to cache them for 24 
hours. 

Refresh the repository webpage to confirm that the new branch was created on origin (1 
in Figure 13.26.8): 


A futureshocked / blank_project_2 © Unwat 


<> Code Issues 1 Pull requests +) Actions LU] Projects D Wiki Security Insights g 


1 
F exporimental2 had recent {fushes less than a minute ago 
P main B, 0 tags Go to file Add file ~ 


e futureshocked Added capacitor. 4389140 31 minutes ago )3.commits 
a Libraries First commit. 39 minutes ago 
gitignore First commit 39 minutes ago 

ì Blank Project 2.kicad_pcb First commit 39 minutes ago 
Blank Project 2.kicad_prl First commit 39 minutes ago 
Blank Project 2 kicad_pro First commit 39 minutes ago 

® Blank Project 2.kicad_sch Added capacitor 30 minutes ago 
fp-lib-table First commit 39 minutes ago 
sym-lib-table First commit. 39 minutes ago 


bredinitherh romMutureenackertiniank proiect Itveeieererimental? 


Figure 13.26.8: The new branch at origin. 


You can use the branch dropdown on Github to switch between branches (2 in Figure 
13.26.8). 


4. Share Github repository with others 

To share your project with others, just give them the repository URL on Github. Your col- 
laborators will be able to clone the repository on their computer, make changes, and then 
push the changes to origin. You can pull the changes to your local repository using the 
"pull*?" command: 


% git pull -u origin experimental2 


The command above will pull changes made to the "experimental2" branch. Change the 
branch name to something else, like "main," to pull changes from any other branch. 


Let's simulate this. You can use Github's edit function to make a change to a repository file. 
Below, 1 am making a small change to the schematic file and saving the change (all done 
on Github, not the local repository): 


42 https://git-scm.com/docs/git-pull 
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<> Code Issues 17 Pull requests (©) Actions LU) Projects LO wiki W Security 1 Insights 


blank_project_2/ Blank Project 2.kicad_sch in main 


<> Edit file > Preview changes 


Seariiteniteri Sse be AA 


a” A s peanae my 
£ (name "~" (effects (font (size 1.27 1.27)))) 
(number "1" (effects (font (size 1.27 1,27)))) 
+ 
(pin passive line {at 0 -3,81 98) (length 1.27) 
20 (name "a" (effects (font (size 1.27 1.27)))) 
(number "2" [effects (font (size 1,27 1,27))1)) 


bel "Example change on Github (was Project nome): lot 129,54 110,49 0) 
0 u pur TOM} } 


(uuid 29ef10b4-8bb7-4b14-8358-c504b2e19438) 
) 


(symbol (lib_id "Device:R") (at 118.11 119,38 0) (unit 1) 

(1n_bon yes) lon board yes) [fields _autoplaced) 

[uuid 82001725-bo88-476c-85ca-302000407287) 

(property "Reference" "R6" (id 0) (at 120,65 118,1099 0) 
leffects (font (size 1,27 1,27)) (justify left)) 

? 

(property "Value" "508R" (id 1} (at 120.65 128.6499 0) 
leffects [font (size 1,27 1.27}} (justify left)) 

) 

(property "Footprint" "" (id 2) (at 116.332 119,38 90) 
(effects (font (size 1.27 1.27)) hide} 

) 

(property "Datasheet" "~" (id 3) (at 118,11 119.38 0) 
leffects (font (size 1,27 1,27)) hide) 


Figure 13.26.9: Made a change to the schematic file at origin. 


Click on the green "Commit changes” button to commit and exit the editor. 
Back on the command line, issue the "pull" command on the "main" branch (where 1 made 


the change): 


% git pull origin main 

remote: Enumerating objects: 5, done. 

remote: Counting objects: 100% (5/5), done. 

remote: Compressing objects: 100% (3/3), done. 

remote: Total 3 (delta 2), reused 0 (delta 0), pack-reused 0 
Unpacking objects: 100% (3/3), done. 


From https://github.com/futureshocked/blank_project_2 


* branch main —> FETCH_HEAD 
d389140..585ff40 main -> origin/main 


Auto—merging Blank Project 2.kicad_sch 
Merge made by the 'recursive' strategy. 
Blank Project 2.kicad_sch | 2 +- 
1 file changed, 1 insertion(+), 1 deletion(-) 
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Git confirms that it has pulled changes in the schematic file of the "main" branch. If you 
switch your local working branch to "main", and then open the schematic in Eeschema, you 
will see the change in the editor: 


Example change on ¿ithub (was Project name): 
R7 
r Da UN coi ee A R 


dg tabetleoas tla Les 
AP 10u T sa aT i bai 50u 


Figure 13.26.10: The change I made on Github appears in the schematic editor. 


In Figure 13.26.10 (above) (above), you can see that the change that I made to the sche- 
matic file on Github appears in the KiCad schematic editor. 

The process I have described above represents a simple use case or creating a new Ki- 
Cad repository, sharing it with other people using Github, and syncing the repository with 
changes made by the project members. 

Github is very versatile, and you can adjust it to your exact personal or team workflow 
requirements. To learn more about it, consider our dedicated Github course* on the Tech 
Explorations website. 


13.27. Customize the editor color scheme 

From its early days, KiCad has been very configurable. In KiCad 6, it is now possible to 
configure the color theme used in the schematic and the layout editors. 

You can create custom color schemes for Eeschema and Pcbnew in the Preferences window. 
Each app has its own theme settings. You can create multiple themes and quickly switch 
between them. See Figure 13.27.1 below for reference: 


43 https://techexplorations.com/so/git-and-github/ 
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... Preferences 
Common Thame: Poters thame 2 [>] Override individual itom colors Reveal Thomes in Finder 
Mouse and Touchpad 
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Editing Ootions 
Bus junetions z= 
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PCB Editor 
Display Options cursor = 
Editing Options Drawing sheet zz suro 
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Grid 
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File: /path/to/eneet 
Junetiona ES 
No-connect symbols MN 
Notes umi ca ese cen eet ar 
i) J 
Pin names a 
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o... Preferences 
Common Thoma: Peter theme 3 in Reveal Themes in Finder 
Mousa and Touchpad 
Hotkeys 
Sthamabe Editor Fou Ey 
Display Options li LI 
Editing Options 
Colors In2.Cu [a] 
Fiala Name Templates In3.Cu al 
PCB Editor 
Ind 0 
Dinpiay Options eae = 
Options In5.Cu [a] 
In. Cu = 
Origins 8 Axes Cu 
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motu [eat] 
Inv.Cu Bea] 
Im2Cu zx 
In13.Cu 
Im4Cu |] 
Int6.Cu 
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Figure 13.27.1: The Colors theme editors for Eeschema and Pcbnew. 


Both editors work the same. You can select a theme via the drop-down menu at the top of 
the editor: 


e 344 


Part 13: Recipes 


KiCad Classic (read-only) 
KiCad Default (read<only) 
o... Peter theme 3 k 
Peters theme 
Common Theme v Peters theme 2 ) 
Mouse and Touchpad 
Cen 
Schematic Editor Axes lerss aT — 
me a Background 
iting Options 
Bus junctions = 
Field Name Templates Buses | 
PCB Editor 
Display Options Cursor =a 
Editing Options Drawing sheet EA 
Shi ERC errors Ee] 
Action Plugins 
| Origins & Axes ERG warnings ai 


Figure 13.27.2: The theme drop-down. 


You can click on "New Theme..." to create a new theme. 

All themes except for the two build-in, "KiCad Classic" and "KiCad Default," are editable. 
To change a color, double-click on the box that contains the color and use the color picker 
or defined colors tabs to select the new color. Then, click on OK to commit the new color. 
For example, to change the color of the background in Eeschema, click on the box that 
contains the background color: 


ene Thome: Peters theme 2 $ Override indvidual tem colors Faves! Themes in Finder 
Moure an Touchpad E 
Honky 
Setamatie Editor Axes ¡symbol ectror oeiy) MN A 
Dia Options Background 
Edtng Antione N 
Bus junctions E 
Field Morro Templates Bures ie eve Color Picker 
PCS Edie 
our 
Dlapiay Options eee i— Cotos Bicker Ofi Color y 
Eieng Options Drwg waet kz Opacity: 
ure 1 
Staa San B = E Be Be Be me. 5 
Origins & Aas Rey = 
oo M Ce ee os om 
ona 
Helper tums: 
= = Mo: Me) Mon: lon: lillian 
Merarchical labels || 
o — = M- Be Be ba 
aunctiono = 
Labais ES Write | om | ene | fee | oom 
No-connect symoos MS 
woes = A a AA AA 
Pareres = | 
Pin numbers = f 
Pre = | 
Seinction righleht ET 
tras 
Sheet Backgrounds Hier Cancel 
m i 


Figure 13.27.3: Assigned Gray 3 to Background. 


In the example above, I have selected Grey 3 from the Defined Colors tab for the back- 
ground. Click OK to dismiss the Color Picker window, and OK again to dismiss the Prefer- 
ences window. 

The schematic editor now looks like this: 
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MCU Datalogger [MCU Datalogger/] — Schematic Editor 


“>A BAZA 


= 
” 


IA AED LAA UNE 


Figure 13.27.4: The schematic editor with Gray 3 for the background. 


You can use the same method to set colors for all available items in Eeschema and Pcbnew. 
I find it helpful to have a theme for regular editing work and another theme for printing. 
Pcbnew's default theme has a black background which is not suitable for printing on paper 
because of the amount of blank ink used. I have a printer-friendly theme with a white back- 
ground so that my layout printouts look better on paper: 
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Figure 13.27.5: Pcbnew using a printer-friendly color theme. 


13.28. Import an EAGLE, Altium, or Cadstar project 

KiCad can work with PCB projects created in the CAD applications. KiCad 6, in particular, 
can import projects from Eagle, Altium, and Cadstar. In most cases, imported projects will 
need editing to correct issues that arose from incompatibilities between these CAD appli- 
cations and KiCad. 

I will show you how to use the import tool using an example. I will import an Eagle project 
for the Arduino Uno board into KiCad. 

Start by going to the Arduino website from where you can download the Eagle files (see 
https://store-usa.arduino.cc/products/arduino-uno-rev3/): 
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OTHER BRANDS + 


+ JOIN NOW! 


<= E + E 


OVERVIEW TECH SPECS | DOCUMENTATION FAQ 


OSH; Schematics 


Arduino Uno is open-source hardware! You can build your own board using the following 


files. 


Figure 13.28.1: Get the Eagle project from the Arduino website. 


The schematic 1 will import into KiCad looks like this: 


o Fi 


same g$ uw 
g 
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Arduino(TM) UNO Rev3 


++ 


BERBER REF 


| 


FH 
ii 
i 
g 
ii 
ji 
# 
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Ee 
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E 
ii 


BERRRRR 


06/07/19 1233 


ARDUINO she: 1/3 


Figure 13.28.2: The Arduino Uno schematic in Eagle. 


Expand the ZIP archive so you can see the two files it contains, the schematic (".sch") and 
the layout (".brd"): 
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Name Size 

EAGLE import-eagle-import.kicad_sym 1.8 MB 
BB EAGLE import.kicad_pcb 50 bytes 

EAGLE import.kicad_prl 1KB 
(E EAGLE import.kicad_pro 9 KB 


ZE EAGLE import.kicad_sch 105 bytes 


E.) empty.kicad_wks 194 bytes 
fp-info-cache 2 bytes 
sym-lib-table 151 bytes 

v B UNO-TH_Rev3e-reference -- 
BB UNO-TH_Rev3e.brd 708 KB 
2.2 MB 


[D UNO-TH_Rev3e.sch 


Kind 


Document 
pcbnew board 
Document 

kicad project files 
eesche...ocument 
pl_edito...cument 
Document 
Document 

Folder 

pcbnew board 
Scheme source 


Figure 13.28.3: The two files of the ZIP file. 


In KiCad, create a new project, and open Eeschema. Then click on File —> Import —> 


Non-KiCad Schematic. 


KiCad File Ed View Place Inspect Tools Preferences 
eee A Save 
A 48 [ HA Save As... 
es 
eee da Insert Schematic Sheet Content... 


a Schematic Setup... 


os 

+ 

> D Page Settings... 

h E Print... Y 
FOF Piot... 


Close 


| 


Help Window 


 RQQAQ Bt: 


in 

— 

Bien | es 
[9 Export > EJ Footprint AS3ignments... 


Figure 13.28.4: Importing a non-KiCad Schematic. 


A file browser will appear. At the bottom of the browser, select the appropriate import file 
format ("1" in Figure 13.28.5), and then select the file with the ".sch" extension ("2" in 


Figure 13.28.5). 
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Figure 13.28.5: Select the file type and then the Eagle schematic file. 


KiCad will try to import this file. KiCad will likely report one or more issues. For example, 
it may not be able to find a matching schematic component (Figure 13.28.6). KiCad will 
report this at the end of the import process. You can use this information to fix any issues 
that arise manually. 


ee Report 


Cauk not find "XTAL{siash}S! in the imparted ibrary 


Qvalopment documents/KiCad 6 test projects/EAGLE impory(UNO-TH_Rew3e-rafecance\NO-TH_Revie.sch_ 
— 
Elapsed tena: 0:00:02 
Cancel 


oK 


Figure 13.28.6: KiCad was unable to find a match for one component. 


Click OK to dismiss the Report window and return to the schematic editor. At first glance, 
the import looks good: 
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| = ma = O ORANG: KARE il 
Figure 13.28.7: KiCad has imported the Arduino Uno Eagle schematic. 


You can compare the screenshot in Figure 13.28.7 (above) with the one in Figure 13.28.2 
and should notice a few differences: 
1. The editor sheet size is wrong. 
2. Text size and type are different. 
3. The black text on the right side of the schematic that appears in multiple lines in 
Eagle appears in a single (very long) line in KiCad. 


You should take a bit of time to fix those issues, especially missing components. In this 
case, I will fix the problem with the single long line on the right side of the schematic simply 
by deleting it (click to select it, then hit the delete key). This will remove the frame around 
the schematic, with its label imported from the Eagle schematic file. With this gone, I can 
move the schematic itself inside the KiCad schematic sheet and select an A3 size sheet 
from the Page Settings window: 
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Figure 13.28.8: Set a new sheet size. 
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The imported schematic for the Arduino Uno now looks like this: 
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Figure 13.28.9: The Arduino Uno schematic imported in Eeschema. 
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Being mindful that different CAD applications have features and capabilities that don't 
"translate" directly to KiCad, you can import schematics from Eagle, Altium, or Cadstar into 
KiCad. In most cases, you will need to do a small amount of editing to correct outstanding 
issues. 


13.29. The circuit simulator 

One of the more frequent questions I receive from readers is about the circuit simulator 
that comes with KiCad. You can find the simulator in Eeschema under the Inspect menu 
(Figure 13.29.1). 


KiCad File Edit View Place Inspect Tools Preferences Help Window 


a Electrical Rules Checker CircuitSimulat 


Previous Marker t E N Ca > A È 
Next Marker 
Exclude Marker 


EX 


mil 
| 


Figure 13.29.1: The circuit simulator in Eeschema. 


The simulator does have a reasonably steep learning curve, but once you learn the basics, 
you will be able to do circuit analysis such as the one in Figure 13.29.2 (below): 


> las, 2 


-tran im = 


srw 
eso iD 2021-07-29 98-05-18 png a. 0 d @ 


LED torch 


Figure 13.29.2: An example simulated circuit and the analysis outcome. 
In the example above, I have simulated the schematic diagram of one of the projects in 


this course (the "LED torch" project). The simulation generated a graph of the voltage and 
current present in the circuit and represented 500 ms of operation. 
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Unfortunately, it is not possible to simulate a standard Eeschema schematic. First, you 
will need to make a few modifications to the schematic so that the simulator can read its 
components. You will also need to assign appropriate models to each of the circuit com- 
ponents and then set the simulation parameters. In the example simulation above (Figure 
13.29.2),the actual file that I simulated looks like the one below (Figure 13.29.3): 


.tran im 500m 


v1 
VSOURCE 


GND 


Figure 13.29.3: This circuit schematic is compatible with SPICE. 


Notice that the new circuit contains a voltage source, and I have removed the switch so that 
the current can circulate. I have also added a text item above the schematic that includes 
the custom simulation directives. 

I will show how to do all this later in this chapter and its segments. 

Before we get started, I will discuss the historical underpinnings of the circuit simulator in 
KiCad. 

The simulator integrated into KiCad is based on SPICE ("Simulation Program with Inte- 
grated Circuit Emphasis"). SPICE is an open-source analog electronic circuit simulator. Its 
development began almost 50 years ago at Berkley University and was originally written in 
Fortran**. The last version of SPICE from Berkey University was published in 1993. Since 
that time, SPICE has seeded several open-source successors, like XSPICE and CIDER. Com- 
mercial versions have also been published, such as ISPICE, HSPICE, and LTSpice. 

KiCad uses the ngspice*® variant, which is open-source. KiCad's spice implementation can 
use models created for the original Spice, as well as LTSpice*®, PSpice and HSpice. A model 
is a file that contains simulation instructions for a component. There are model files for any 
component in a circuit, such as resistors, transistors, and voltage sources. KiCad's simula- 
tor compatibility with models from the various variants for Spice means that you can use 
models published by a large group of authors and companies. 


44 https://en.wikipedia.org/wiki/Fortran 
45 http://ngspice.sourceforge.net/ 
46 https://en.wikipedia.org/wiki/LTspice 
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Resources 
In this chapter, I will give you a demonstration of the circuit simulator in Spice. As Spice is 
a complicated tool, I will certainly not cover more than some of the basics. To learn more, 
I suggest you use these resources: 

1. KiCad Spice documentation”. 
Ngspice documentation*, 
The Spice page O Berkeley?*”. 
The Spice circuit elements and models” (also @ Berkeley). 
The presentation slides from course ECE220, "Introduction to spice source files>" 
(California State Polytechnic University, Pomona). 


oP wns 


13.29.1. Prepare the circuit for simulation 

To use KiCad's circuit simulator, the first task is to edit the schematic analyzed by the Spice 
simulation engine. 

In my example (see Figure 13.29.1.4 below), I have made a couple of small modifications: 


SW_DPST_x2 


tep LED anod: - 
zas- ee EE > qo OT 


Battery_Cell LED_cathode i ___bat-pos 
+ 


Using coin cell 
+ battery bolder. 
\ 


GND \ 
Figure 13.29.1.4: Original schematic (right), SPICE-compatible schematic (left). 


The first modification is the voltage source. Many components (mainly passive ones, like 
resistors and capacitors) have symbols with SPICE models already defines. But others, 
such as the battery symbol in the example above, are not. It is possible to define a custom 
simulation model for symbols, but in the case of the battery, the simplest way to deal with 
it is to insert a voltage source symbol from the SPICE library. The voltage source symbol 
contains configuration parameters that the simulator can use in its analysis. 

There are two steps to set the voltage source for this circuit: 

1. Disable the battery cell for the simulation since I will not provide it with a SPICE model. 
2. Add a voltage source and use either wires or labels to connect it to the circuit (thus re- 
place the battery cell). 


To disable the battery cell from the simulation, double-click on the battery symbol to bring 
up its properties window, click on the "Spice Model" button to bring up the spice model 
editor window, and check the "Disable symbol for simulation" box. Click OK and Ok to go 
back to the editor (Figure 13.29.1.5): 


47 https://www.kicad.org/discover/spice/ 

48 http://ngspice.sourceforge.net/ 

49 http://bwrcs.eecs.berkeley.edu/Classes/IcBook/SPICE/ 

50 http://bwrcs.eecs.berkeley.edu/Classes/IcBook/SPICE/UserGuide/elements_fr.html 
51 https://www.cpp.edu/~prnelson/courses/ece220/220-spice-notes. pdf 
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Stew pn rumoer 


Figure 13.29.1.5: Disable the battery symbol for the simulator. 


Next, you must provide a voltage source for the circuit symbol to replace the disabled bat- 
tery symbol compatible with Spice. For this purpose, KiCad offers a library of Spice sym- 
bols. Choose the symbol tool from the right toolbar in Eeschema, and search for the spice 
(or "pspice" library). One of the symbols in that library is "VSOURCE" (Figure 13.29.1.6): 


Choose Symbol (18089 items loaded) 


pspice 
o 
BSOURCE 
c 
CAP 
DIODE 
ESOURCE 
GSOURCE 
INDUCTOR 
ISOURCE 
MNMOS 
MPMOS 
OPAMP No default footprint 
QNPN 
QPNP 
R 


NSOUIGE 
SIMUISUO ANSP 


VSOURCE 
Voltage source symbol for simulation only 
Keywords: simulation 


No footprint specified 


Reference V? 
Footprint 
Datasheet ~ 


Select with Browser Place repeated copies Place all units E) Cancel PRA 


13.29.1.6: A voltage source symbol that is compatible with the simulator. 


After you add the new voltage source in the editor, do the wiring. 1 prefer to use labels 
for a cleaner look. In Figure 13.29.1.4, notice how I have attached the "Vin" label and the 
GND symbol to the voltage source and the rest of the circuit schematic around the original 


battery cell symbol. 
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Let's drill into the voltage source symbol. Double-click on the voltage source symbol to 
bring up its properties window and click on the "Spice Model" button to see the Spice model 
editor window. 

Every symbol in KiCad has a Spice model editor that you can use to set various parameters 
related to the simulation, including attaching code representing the simulation model of the 
real-life component. 

The Spice model editor window contains three tabs: Passive, Model, and Source. Since 
I am working with the voltage source symbol, I click on "Source." This is where you can 
configure your power source. For example, you can set the source to operate in a pulse, 
sinusoidal or exponential pattern. Of course, you can set it as a simple DC or AC source. 
Below I have set the voltage source to produce a sinusoidal output with 5V amplitude at 10 
Hz (Figure 13.29.1.7). 


o... Spice Model Editor 
cams wae 
DC/AC Analysis 
DC: 5 Volts/Amps 
AC magnitude: Volts/Amps AC phase: radians 


Transient Analysis 


Pulse Sinusoidal | Exponential — Piece-wise Linear FM AM Random 


DC offset: Volts/Amps 

Amplitude: Volts/Amps 

Frequency: Hz 

Delay: seconds 

Damping factor: Vseconds 
Source Type 


O Voltage Current 


Disable symbol for simulation 


Alternate node sequence: 


cancel QUIET 


13.29.1.7: The simulation configuration for the voltage source. 


Let's look at the other component in the circuit. First, the resistor, a passive component. 
Below you can see its simulation spice model (Figure 13.29.1.8): 
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[ e Spice Model Editor 
Type: Pasie type 


Value: Spice value in simulation 


In Spice values, the decimal separator is the point. 
Values can use Spice unit symbols, 


Spice unit symbols in values (case Insensitive): 


f femto 18-15 
p pico te-12 
n nano 1-9 
u micro 1e-6 
m milli 10-3 
k kilo 13 
meg mega 1e6 

g giga 189 

t terra 1e12 

Disable symbol for simulation 


Alternate node sequence: 


Cancel 


13.29.1.8: The configuration for the resistor. 


The resistor is a passive component, so I have clicked on the "Passive" tab to reveal the 
relevant options. From the "Type" drop down, I have selected "Resistor", and typed "200" 
in the "Value" field. If I want to set a 1kQ resistor, I would type "1k" (notice the Spice unit 
symbols table below the fields). The Type drop down contains options for "resistor", "ca- 
pacitor" and "inductor". 

Click OK and OK to return to the editor. 

Let's work on the LED next. The LED is a semiconductor component, not passive. For this 
reason I will need to specify a compatible Spice model. You can find Spice models for 
components by doing research on the Internet, or by writing them yourself. Component 
manufacturers often publish Spice models with their products (examples: Analog Devices””, 
Microchip*?, National Instruments, PSpice”*, Littlefuse*”, Diodes**). Universities or individ- 
uals also publish models on their websites (Examples: Berkeley University”, All About 
Circuits*8), 


52 https://www.analog.com/en/design-center/simulation-models/spice-models.html 

53 https://www.microchip.com/doclisting/TechDoc.aspx?type=Spice 

54 https://www.pspice.com/ 

55 https://www.littelfuse.com/technical-resources/spice-models.aspx 

56 https://www.diodes.com/design/tools/spice-models 

57 http://bwrcs.eecs.berkeley.edu/Classes/IcBook/SPICE/UserGuide/analyses_fr.html 

58 https://forum.allaboutcircuits.com/threads/the-libraries-and-components-models-of-ltspice-free- 
download.133690/ 


e 358 


Part 13: 


Recipes 


Models are distributes as text files like this (here is my source”): 


*Typ RED GaAs LED: Vf=1.7V Vr=4V If=40mA trr=3uS 
.MODEL LED1 D (1S=93.2P RS=42M N=3.73 BV=4 IBV=10U 
+ CJO=2.97P VI=.75 M=.333 TT=4.32U) 


*Typ RED,GREEN,YELLOW,AMBER GaAs LED: Vf=2.1V Vr=4V If=40mA trr=3uS 


.MODEL LED2 D (IS=93.1P RS=42M N=4.61 BV=4 IBV=10U 
+ CJO=2.97P VI=.75 M=.333 TT=4.32U) 


*Typ BLUE SiC LED: Vf=3.4V Vr=5V If=40mA trr=3uS 
.MODEL LED3 D (1IS=93.1P RS=42M N=7.47 BV=5 IBV=30U 
+ CJO=2.97P VI=.75 M=.333 TT=4.32U) 


You can save this model in a text file and import it to the KiCad symbol or copy/paste using 
the spice model editor. For the LED symbol, double-click on it to bring up its Properties 
window, then click on "Spice Model." Once the Spice Model Editor window is up, click on 
the Model tab, and copy/paste the model from the sample above into the model text field 


(Figure 13.29.1.9): 


ee Spice Model Editor 


Passive Model Source 
Library: Spice models/led2.model 


Model: LEDI 


Type: Diode 


Note: Symbol pin numbering don't always match the required SPICE pin order 

Check the symbol and use "Alternate node sequence" to reorder the pins, if necessary 
For a Diode, pin order is anode, cathode 

1 *Typ RED GaAs LED: Vf=1.7V Vr=4V If=40mA trr=3uS 

2 .MODEL LEDI D (15=93.2P RS=42M N=3.73 BV=4 IBV=10U 

a + CJO~2.97P VJ”.75 M=.333 TT”4.32U) 

$ “Typ RED,GREEN, YELLOW, AMBER GaAs LED: Vf=2.1V Vr=4V If=40mA trr=3uS 

6 .MODEL LED2 D (15=93,1P RS=42M N=4.61 BV=4 IBV=10U 

7 + CJO=2.97P W=.75 M=.333 TT=4.32U) 

8 

9 *Typ BLUE SiC LED: Vf=3.4V Vr=SV If=40mA trr=3uS 


10 .MODEL LED3 D (IS=93.1P RS=42M N=7.47 BV=5 IBV=30U 
11 + CJO=2.97P Vj=.75 M=.333 TT=4.32U) 
12 


13 


Disable symbol for simulation 


Alternate node sequence: 


13.29.1.9: Setting the Spice model for the LED symbol. 


In the screenshot above, I have used the file method. I saved the model in a text file titled 
"led2.model" and used the file browser to find it and select ("1" in Figure 13.29.1.9). 


59 https://newbedev.com/simple-led-model-for-circuit-simulation 
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The model file contains three individual models. Each has a unique name: "LED1", "LED2", 
and "LED3". I selected the model I wanted to use using the Model drop-down menu ("2" in 
Figure 13.29.1.9). 

The various parameters that you see in the model definitions, such as "IBV" (Current 
at Breakdown Voltage), "BV" (Reverse Breakdown Voltage), and "TT" (Transit-time), are 
described in the Ngspice user manual*. You can find these values in a component's data- 
sheet; you can use these values in your models. 

Click OK and OK to get back to the editor. 

The circuit schematic is now ready for the simulation. In the next segment of this chapter, 
I will show you how to configure the simulator. 


13.29.2. Configure the simulator 

In the previous segment, I prepared my circuit schematic for analysis by the simulator. In 
this segment, I will configure the simulator. Compared to the work needed to prepare the 
circuit for the simulation, the simulator's configuration is much simpler. 

To configure the simulator, there are generally two steps to complete: 

First, set the spice simulation settings. These settings control things such as how many 
simulation points to calculate, the start and stop frequencies (for AC voltage sources), the 
behavior of the DC power source(s), the time step, and initial/final times. 

Second, set the simulation probes to capture the simulation voltage and current data. 

A convenient way to configure the simulator so that the settings persist is to create a 
text item above the circuit schematic and type the configuration string there. In Figure 
13.29.2.10 (below) you can see the configuration string inside the yellow box: 


tran dm 500m 


vi E 
VSOURCE 


Battery_Cell 


GND 
13.29.2.10: The simulation configuration. 


The simulator will detect the presence of the configuration string and read it, saving you the 
hassle of manual configuration every time you open Eeschema. 


60 http://ngspice.sourceforge.net/docs/ngspice-manual.pdf 
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Let's see the impact that the configuration string has on the simulator. Bring up the simu- 
lator window by clicking on Inspect, Simulator. In the simulator window, click on the Sim 
Parameters button (Figure 13.29.2.11). 


{Unsaved} — Spice Simulator 
J 2 


Sim Parameters 


Signais 


... kr Simulation settings 


AC DC Transfer Operating Point Custom 


Tima step: Im seconds 
Final time: 500m seconds 


Initial time: seconds (optional; default 0) 


Adjust passive symbol values (e.g, M > Meg; 100 nF > 100n) 
Add full path for include library directives 
Compatibility mode: — LTSpice 8 


Cancel CI 


13.29.2.11: The simulation settings. 


The simulation settings window will appear. The simulator has already read the information 
in the settings string from Figure 13.29.2.10 and has populated the "Time step" and "Final 
time" text boxes in the Transient tab. Compare the values in the text boxes with those in 
the configuration string and notice that they match. 

Before you close the simulation settings window, browse the contents of the other tabs to 
see some of the other available options. Click on the "Custom" tab to see the configuration 
string copied there from the schematic. 

My simulation is now configured to start from time O ms to 500 ms, at a step of 1 ms. In 
total, the simulator will calculate 500 points of whichever values to set next. As the number 
of points increases, so does the amount of time the simulator will need to finish the work, 
so choose reasonable values for the simulation time. 

If you make a change to the text string in the editor ("1", below), you can update the simu- 
lator configuration by clicking on the button "Load directives from schematic" ("2", below), 
under the Custom tab (Figure 13.29.2.12): 


e 361 


KiCad Like a Pro, Projects, Tips and Recipes 


* [Umeved] = Spice Sida 
> A 
tran 1u 1000m A — z i 


ME behes poe Mob Tani Custam 
Sperm dro 
beres tu 18008 


13.29.2.12: Updating simulation directives from the schematic. 


I am almost ready to start the simulation. The last task to complete is to indicate the val- 
ue(s) I'd like to capture to the simulator. Say I want to capture the current that is coming 
out of the LED. For this, I will add the signal (Id for D1) to the list of captured signals. Click 
on the "Add signals" button to bring up the signals window in the simulator window. Then 


select "Id(D1)" and click OK (Figure 13.29.2.13). 


* (Unsaved] — Spice Simulator 


> hb ASL e 


Ado Signatn 


Plot? - TRAN © Signals 


NBT) 
HRI) 
itv) 


Viva) 
vevin) 


Circuit; KiCad schematic 


Add signal by name: 
paa a s l 


13.29.2.13: The simulator will capture the signal "Id(D1)". 


You may choose more than one signal if you wish. 
The simulator is now ready to run. Let's do that in the next segment of this chapter. 
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13.29.3. Simulate 

Time to simulate! 

In Eeschema, open the simulator window (Inspect —> Simulator). Click the blue play but- 
ton to run the simulation (Figure 13.29.3.14). 


eee * [Unsaved] — Spice Simulator 


Plott - TRAN © Signals 


Signal 


-EJ 


Cursors 
Signa Time Voltage / Curr 


Circuit: KiCad schematic Tune 
Doing analysis at TEMP = 27.000000 and THOM = 27.000000 
Initial Transient Solution 


Node Voltage 


fui 6.347490-25 
vin o 3 
vi#branch 3,173758-27 

Reference value : 0.00000e+00 


Mo. of Data Rows : 521 


13.29.3.14: The simulation results. 


My simulation only contains 500 points, so it is very quick to finish. In the screenshot 
above, you can see the simulated signal (1), the plot (2), and the results (3). 

You can create additional plots as needed. With the simulation window active, click "File," 
then "New Plot." A new tab will appear in the simulator window that contains a blank plot. 
Let's add a new signal. With the new plot tab selected, click on "Add Signals" and select 
"V(V1)" from the list. Click OK. The simulator will immediately draw the plot for the new 
signal (Figure 13.29.3.15): 
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e * [Unsaved] — Spice Simulator 
» m AS, & 
D Plot2 - TRAN Y Signals 
Signal 
m 
Cursors 
Signal Time 
Circuit: KiCad schematic Tune 
Doing analysis at TEMP = 27.000000 and TNOM = 27.000000 
Initial Transient Solution 
Node Voltage 
/vi 6.347490-25 
vin 
vlWbranch 3.17375e-27 
Reference value + 0.00000e+00 
No. of Data Rows : 521 


13.29.3.15: Plot for signal V1 in a new tab. 


Of course, you can plot more than one signal on a single plot. Let's try one. Create a new 
plot, and assign it signals "Id(D1)" and "V(V1)" (you can multiple-select by holding down 
the Command or Control key as you click on a row). The new plot looks like this: 


a * [Unsaved] — Spice Simulator 


Q © Piot3 - TRAN © Signals 

Signal 

= V1 
D1 


Cursors 
Signal Time 


50ms 


Circuit: KiCad schematic Tune 
Doing analysis at TEMP = 27.000000 and TNOM = 27.000000 
Inítial Transient Solution 


Voltage 

aes 6.347498-25 
in 

igbranch 3.17375e-27 


Reference value : 0,00000e+00 


lo. Of Data Rows : 521 


13.29.3.16: A plot with two signals. 
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The simulator plots are interactive. You can use your mouse and its scroll wheel to zoom 
in and out and pan. 


Center 
Fit on Screen 


EXT 


Zoom Wut 


350ms 400ms 450ms 


13.29.3.17: Context menu options for the plot. 


You can also set a cursor on a signal so that you can look at values at specific points on a 
signal's plot: 


Signals 
Signal 
om /V1 


ma [ 
Ti Hide Signal 


Cursors 
Signal 


13.29.3.18: Using the cursor on signal D1. 


You can also zoom into a specific region of the plot by drawing a rectangle with your mouse: 


100ms 150ms 300ms 


13.29.3.19: Zoom in to a region of the plot. 
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Let's make a change to our circuit and rerun the simulation. For the new experiment, I will 
change the voltage source configuration to be a 5 V stable source. Make the change in the 
voltage source symbol like this (see DC field in "Source"): 


o e Spice Mode! Editor 


Passive Model Source 


DC/AC Analysis 


DC: | Volts/Amps 


AC magnitude: Volts/Amps AC phase: radians 


Transient Analysis 


Pulse Sinusoidal Exponential Piece-wise Linear FM AM Random 


DC offset: Volts/Amps 

Amplitude: Volts/Amps 

Frequency: Hz 

Delay: seconds 

Damping factor: seconds 
Source Type 


O Voltage Current 


Disable symbol tor simulation 


Alternate node sequence: 


À 


13.29.3.20: Changed the voltage source to 5 V stable. 


Return to the simulator window and click on the blue play button to run the simulation. No 
need to change any of the simulator settings. The new Plot3 looks like this: 


Voltage Current 


1.878mA 


-1.878mA 
1.878mA 
1,.878mA 
-1.878mA 
1.878mA 
1.878mA 
-1.878MA 
~1.878mA 
1.878mA 
-1,878mA 
-1.87BmA 
1.878mA 
1.878mA 
-1.878mA 
1.878mA 


1.878mA 
200ms 5 300ms 350ms Gi 500ms 


13.29.3.21: A new plot with the new voltage source settings. 
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With these basic simulator skills, you can try out a variety of scenarios. For example: 
e What would happen to the voltage and current on the diode if the source voltage is 
3V instead of 5V? 
e What if it is a small AC voltage at 10Hz? 
e What if you used a different type of LED? 
e What if you double the value of the resistor? 


These questions and many more are now easy to answer with the help of the simulator. 


13.30. Import a KiCad 5 project 

If you have KiCad 5 project that you would like to use with KiCad 6, you can import them. 
However, remember that KiCad 6 has introduced several significant changes in the project, 
schematic, layout, and library file formats. Because of these differences, importing a KiCad 
5 project to KiCad 6 is possible but not straightforward. 

This chapter will show you how you can import a KiCad 5 project into KiCad 6 using an 
example. 

First, a review of the file format and project organization changes. In Figure 13.30.1 (be- 
low) you can see the project directories and file organisation of a KiCad 5 project (left, 1) 
and KiCad 6 project (right, 2). 


DD KiCad 5 projects 


fp-info-cache Zero bytes Documer > EJ 4x8x8 LED Matrix Clock Gerbers 
TT Gerber_RPFSHAT de > OD 4x8x8 LED Matrix Clock-backups 
' Gerber_RPFSHAT.zip 21P archive (BB 4x8x8 LED Matrix Clock kicad_peb 
RPI FS HAT v3-cache. lib si (Gem 4x8x8 LED Matrix Clock kicad_pri 


Name 


ES A CË 4x8x8 LED Matrix Clock kicad_pro 


ZE 4x8x8 LED Matrix Clock.kicad_sch 


RPi FS HAT v3.kicad_pcb 
S i v3.kicad_pc fp-info-cache 


RPI FS HAT v3.kicad_pcb-bak 
Eb RPI FS HAT v3.net 
Ki RPi FS HAT v3.pro 
JE RPI FS HAT v3.sch 


Figure 13.30.1: Project directories and organization. KiCad 5 (left) KiCad 6 (right). 


In KiCad 5, the project (".pro") file and schematic (".sch") file do not use the KiCad 6 new 
S-Expressions format. Still, in KiCad 5, the layout (".kicad_pcb") file does use the S-Ex- 
pressions format, making it easy to import into KiCad 6. 

You can see examples of the content of those files below (Figure 13.30.2): 


e 367 


KiCad Like a Pro, Projects, 


Tips and Recipes 


A a 


5 A 
Ebschesa Schematic He Version 4 


EELAYER 26 0 
EELAYER END 

Sdescr M 11693 0768 

encoding utt-8 

Sheet 11 

Title “Raspberry Pi (wll Stack MAT 
Date "2018-11-29" 

ha "3" 

Comp "Tech Explorations” 

Commenti “Designed by Peter on Earth" 
Corment2 “" 

Coment "” 

Comenta "" 

SEnddescr 

store 

L Coomactor:Raspberry_P1_2.3 31 

UY 11 5051208 


Errar ra ena 


hipdate=22/05/2015 07:44:53 
vers Lone: 

last 57 a 

Ipeneral} 

vers lon=1 

RootSch= 

BoardNe= 

Ipebnew! 

vers lon=1 

LastietL istñead= 

UseCapr i le=1 
PadDri1!=9.5089090000800 
PadDrillDvalY=0. 580000000000 
Pads 170H”1, 500000000000 
Pods izev=1. 500000000000 
PchTextSizeV=1. 500000000000 


enw arena e E 
{hicad prb (version 20171130) (host pebnew 5, 


n mnam n 


(general 
(thickness 1,6) 
(erfuinas 3) 
(tracks 71) 
(zones 0) 
(modules 11) 
(nets 18) 

) 


(page A4) 
(title_block 
(title “Raspberry Pi Full Stack HAT") 
(date 2013-11-30) 
(rev v3) 
(company “Tech Explorations") 


PcùTextSizeh=1. 500000000000 t hen rege Earn” 
PcbTextThickness=#. 30000000000 a SA 
ModuleTextS120V=1. 000000000004 


a KiCad 5 project EJ KiCad 5 layout 


Figure 13.30.2: KiCad 5 file format examples. 


P 5775 3750 
ra" "a1" M 6250 5175 50 mor com 


E KiCad 5 schematic 


In KiCad 6, all three files (project, schematic, and layout) use the S-Expressions format. 
To facilitate the import of the KiCad 5 project to KiCad 6, KiCad 6 has an import utility that 
will handle the conversion of the legacy project and schematic files to use the new S-Ex- 
pressions file format. The importer will also try to find appropriate matches for schematic 
symbols in the originating project. When the importer can't find suitable symbols, it will ask 
you to find a replacement manually. 

Let's look at an example. 

In Figure 13.30.1, you can see my old KiCad 5 project (left, 1). I will import this project 
into KiCad 6. 

In Figure 13.30.1, you can see my old KiCad 5 project (left, 1). I will import this project 
into KiCad 6. 

The importer "hides" in the regular Open option under File, in the KiCad 6 project window 
(Figure 13.30.3): 


Kicad File 


~ 

5 

GA A 

= E import Non-kiCad Project... > | SS 
RE pe 


® Unarchive Project... 


maul Gerber| 
Figure 13.30.3: Open a KiCad 5 project as you would any KiCad project. 


KiCad will ask for the location of the project. Navigate and select the file with the ".pro" 
extension in the KiCad 5 project directory: 
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iii 
< 
EE 
< 


Name 


~ DD RPI FS HAT v3 
> E Gerber_RPFSHAT 


ir 


Options 3, 


Open Existing Project 


Ex KiCad 5 projects Q 


Date Modified Size Kine 


Today at 11:54 am Folder 


Today at 11:54 am -- Folder 


Se 


Cancel 


Figure 13.30.4: Open the ".pro" file. 


Click "Open." The KiCad project window will show the project contents: 


e... 
Project Flies 
GB pris HAT v3.kicad_pro 


= [Bi Gerber_nprsHaT 

m BE\ fri FS HAT v3-cache.lib 
ye RPIFS HAT vI.kicad_peb 

s Drei FS HAT va.net 

FP rrrsHaTvash 


RPI FS HAT v3 — KiCad 


SELLEL Y 


Schematic Editor 
Edit the project schematic 


Symbol Editor 
Edit giobal and/or project schematic symbol Nbrarios 


PCB Editor 
Edit the project PCB design 


Footprint Editor 
Edit global and/or project PCB footprint libraries 


Gerber Viewer 
Preview Gerber files 


Image Converter 
Convert bitmap images to schematic symbols or PCB footprints 


Calculator Tools 
Show tools for calculating resistance, current capacity, etc. 


Drawing Sheet Editor 
Edit drawing sheet borders and title blocks for use in schematics and PCB designs 


Figure 13.30.5: My old KiCad 5 project in the KiCad 6 project window. 


Next, let's open Eeschema and check if there is any manual work left to be done. Click on 
the Schematic Editor button to open Eeschema. The project rescue helper window will ap- 
pear. The window contains information about the symbols that the importer has updated 
and requests your approval (Figure 13.30.6). 
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o o Project Rescue Helper 


This schematic was made using older symbol libraries which may break the schematic. Some symbols may need to be linked to a different symbol name. Some 
symbols may need to be “rescued” (copied and renamed) into a new library, The following changes are recommended to update the project. 


| Symbols to update: 
Accept Symbol Name Action Taken 


Connector:R..berry Pi_23 Rescue modified symbol Connector:Raspberry_Pl_2_3 to RPI-FS-HAT-w3-rescue:Raspberry_Pl_2_3-Connector 
Sensor:DHT11 Rescue modified symbol Sensor:DHT11 to RPI-FS-HAT-43-rescue:DHT11-Sensor 


Instances of this symbol (1 items): 


Reterence Value 
J1 Raspberry_Pi_2_3 


Cached Symbol; Library Symbol: 


Never Show Again Cancel 
Figure 13.30.6: The importer has done all the work; ¡t is prudent to double-check. 


It is also possible that the importer has not been able to find a suitable symbol replace- 
ment, in which case it will ask you to find one. In the example above, 1 double-check that 
the symbol updates are appropriate. To do this, I use the Helper tool's information in the 
list "Symbols to update.” Click on a row to see more details in the lower part of the window, 
including the symbol graphics, so that you can visually confirm the updates. 

I accept the updates and click OK. The schematic editor appears and contains my updated 
project schematic: 
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*RPI FS HAT v3 [RPI FS HAT v3/] — Schematic Editor 


Dee Ooo? Ps TAQAAQ Bi s4FA RA FLSBES BS 


fs He 


Ni — Momentary button N2 — Sensor N3 — Raspberry Pi 


FV 8 I 


Swi 
Sw_DPST 


j 
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| 


of cual 


tj 

fi | 

Y E GND 
ji i 


A a cee NETA 1 RE PD IT AAN mp 
fi | a, Raspberry PIA j 


EPA PASE ES AS PAE AO < arg tc ete 


dBat ADIDAS ED A 


Figure 13.30.7: The updated project schematic. 


Take the time to visually inspect the schematic in the editor and make any chan 


ges neces- 


sary as you would with any KiCad 6 schematic. Notice the warning band at the top of the 
editor. This indicates that the conversion is not yet complete. It will be done once you save 


the schematic. Type "Cmd-S" or "Ctr-S" to save the schematic to disk and co 
conversion. The warning will go away. 


mplete the 


Return to the KiCad project window and also look at the project directory contents. Notice 


that there is a new file with the ".kicad_sch" extension. This file contains the 
editor data using the new KiCad 6 file format (Figure 13.30.8). 


schematic 


7 


Wi FS HAT va — 1063 S 
: = = A ece < Kicad 8 projects 
‘Schematic Editar 
ir 

E roses nar va.kicod_pro posi a pe 
> ID cocer arrour ~ DE ROL PS HAT va 
HD) fer Fs Har vs-cacna tio ‘Symbol Editor 
Ml mes rs HAT vt-rescun tte Ale prodas cos praject soframatis symbol Abracias > D Gerber RPFSHAT 

HAT 
GB vos Har ccoo rate 
By PA Fo HAT v3.b:ced_pro Edt the projot PCE design PPI FS Hur v3-cacha Mo 


Fo... er 


Does es nar vine 


Image Converter 
Convert bitmap images to schematic symbais or PCB foatorines 
3 C RPI FSHAT vd pro 


Calculator Toots 
Show no's far cakculating sesntance, zwen? canacty. rte. syrtib-table 


Figure 13.30.8: The new KiCad 6 schematic file. 


The original ".sch" file is still in the project directory. You can delete it if you wish or keep 
it in case you need to use it later. The same applies to the old ".pro" file, replaced by the 


new ".kicad_pro" file. 
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Continue with the layout editor. Click on the Pcbnew button in the KiCad project window or 
Eeschema. The layout editor will appear (Figure 13.30.9): 


eee "RPI FS HAT v3 — PCB Editor 
y ` A r*@QoqQqeac A A [A pm > ~ 
aeDeos PTQQAQQQ LSA Hag BB Ble mer mse 
Track: use netclass width G la Via: use netciass sizes @ Grid: 25.400 mm (0.1000 im) B zomat E 
‘This fila was created by an aldar version of KiCad. It will be converted to the new format when saved. k 


ra 

a, 

o 

E 

ÉS 

rA 

r 

(m) 

. © 

Qlan- A2 PWR Y 
P past ECT T 
y $ 

+ 

b 

i+, 

O 


Presea ¿Carlo Tato 


Padu Vias Track Segments Nodes Neta Unrcuted 
1 $5 y 


Z758.  K1I6BADO Y 638200 as 118 8400 ay 838200 Sst 1437983 era Y 2.5200 mes Y 2.5400 mm mm 


Figure 13.30.9: The KiCad 5 layout file in KiCad 6. 


Pcbnew does not show a project rescue helper, only a warning that the conversion will be 
finished when the file is saved. Save the file to dismiss the notification and complete the 
conversion. 

Because the layout editor depends on the schematic editor if you see problems (like incor- 
rect layouts), the first place to look for clues is the schematic editor. Other issues that I 
have noticed in Pcbnew when importing Kind 5 projects are related to things like the grid 
size, text sizes, and colors. In most cases, you will be able to resolve all issues within a few 
minutes. 


13.31. KiCad project templates 

KiCad project templates can save you a lot of time when you start a new project. With a 
KiCad project template, your new project is pre-configured. It has its schematic layout 
editors already populated standard components that can form the basis you can build on. 
You can choose one of several templates that KiCad ships with or create yours. You can 
create a user template from any of your existing KiCad 6 projects. In this chapter, I'll show 
you both options. 
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Template locations 

KiCad system and user template are stored in specific directories. You can find and/or 
change those directories in your instance of KiCad in the "Configuration Paths" window 
(Figure 13.31.1). While in the KiCad project window, click on Preferences, Configure Paths. 


e o Configure Paths 


Environment Variables 


Name Path 
KICAD6_3DMODEL_DIR {Volumes/RAID/Kicad Projects/Library/kicad/3dmodels/ 
KICAD6_FOOTPRINT_DIR [Volumes/RAID/Kicad Projects/Library/kicad/modules/ 


KICAD6_SYMBOL_DIR {Volumes/RAID/Kicad Projects/Library/kicad/library/ 
KICAD6_TEMPLATE_DIR | /Volumes/RAID/Kicad Projects/Library/kicad/template/_ 
KICAD_USER_TEMPLATE_DIR /Users/peter/Documents/Kicad/Course development documents/Templates 


? Cancel 
Figure 13.31.1: The Configure Paths window. 


Notice that there are two template directories: 
1. KICAD6_TEMPLATE_DIR, where you can find the system templates. 
2. KICAD_USER_TEMPLATE_DIR, where you can store your custom templates. 


The source of the system project templates is located on Gitlab**, You can periodically look 
at Gitlab for new or updated templates and copy them to your KiCad instance system tem- 
plate directories. 

Later in this chapter, I will show you how to create a custom project template. I will save 
mine in the specified KICAD_USER_TEMPLATE_DIR directory. 


13.31.1. Using a system project template 

A "System template" is a template that KiCad provides. For example, system templates 
contain Arduino Mega, Beaglebone Black, Raspberry Pi, or STM32 projects. Let's look at an 
example. 

I will create a new project that uses the Arduino Mini system project template. 

Start KiCad and open the main project window. From the File menu, select "New Project 
from Template..." (Figure 13.31.1.2). 


61 https://gitlab.com/kicad/libraries/kicad-templates/-/tree/master/Projects 
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é KiCad File View Tools Preferences Help 


eee 5 New Project... ojec 
& ' New Project from Template... . #T 
i Ge Open Project... 
© Open Recent > 
ra 16) 
RI 
r B Import Non-KiCad Project... > 
$ 
Y Unarchive Project... 


Figure 13.31.1.2: Create a new project from a template. 


The Project Template Selector window will (Figure 13.31.1.3). Select the "System Tem- 
plates" tab (1), use the scroller to pan the project templates left and right, and find the 


Arduino Mini template. Click to select it (2). 


In the information pane (3), you will see a description of the template, including a view of 
the footprints and schematics that it contains. The information you see on the information 
page (3) is a simple HTML file. The creator of the template can provide as much or as little 


information as they want. 


Notice the location of the selected template in the folder text box (4). 


Click OK (5) to continue. 


ere Project Template Selector 


E... Tomplates Usor Templates 


This project template is the basis of an expansion board tor the Arduino Mini VOS 
This base project includes a PCB edge defined as the same 
ize as the Aran Mei VOS 2 PCB with the connectors placed 
correctly to align tha two boards. 
tours and holes can be easely modified, just remove Ine or hole 
Ina nds beer you hav be potion c Rose bunion, 


The final PCS looks Ilka the folowing: 


Folder: (Volumes/RAID/Kicad Projects/Libraryikicad/tempaate) ES 


Browse 


Cancal 


ARDUINO ARDUINO ARDUINO NO ARDUINO Fruta TETE 
Fio MEGA MICRO “MINI ‘NANO. Pro Mini UNO on aa ha 


Arduino Fi Arduino M Arduino M Arduino M ArduinoN Arduino Pr Arduino as BeagleBon EuroCard 1 Eurocard 1 MinnowBo Raspberry Raspberry Ras; 


Figure 13.31.1.3: The project template selector. 
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KiCad will ask you to choose a location for the new (Figure 13.31.1.4). Give the project a 
name (1), check the new folder box (2), and click "save" (3). 


Save 


New Project Folder 


r 


Project from template 1 


< Z. By Ex KiCad 6 test projects B - Q 


Nam ate Modifie Size 
> DD Arduino Nano clone 15 021 at 2:18 prr — Folde 
> DD Blank Project 27 Jul 2021 at 8:34 an Fo 

My Blank Project 2 4 Sap 2021 at 7:27 an Folde 


Create a new folder for the project 


New Folder Cance Save | 


Figure 13.31.1.4: The location for the new project. 


The new project, using the settings and starting schematic and layout from the project 
template, is ready. 

Open the schematic and layout editors to see what the project looks at the moment (Figure 
13.31.1.5): 


EY Be 


Y 
Al 
4 
& 
% 


eG 


Eeschema Pcbnew 


Figure 13.31.1.5: The new project, with the two editors populated. 


As you can see, the new project is not blank. It contains the starting schematic and layout 
as inherited by the Arduino Mini template. 


e 375 


KiCad Like a Pro, Projects, Tips and Recipes 


13.31.2. Create a user project template 

It is possible to create custom user templates from your existing KiCad projects. When you 
have created a user project template, it will be available for use in the User templates tab 
of the Project Template Selector window: 


eve Project Template Selector 


2| System Templates User Templates EN 


This is a an example project template. 


Ihave created this template from the first project of the course "KiCad Like a Pro, 3rd edition". 


Folder, /Users/peter/DocumentsKicad/Course development documents/Templates/ 4 | Browse — Validate 


Cancel OK 


13.31.2.6: The User Templates tab. 


In the example above, I have selected the User Templates tab (1) to see a single user 
project template (2). The information pane (3) contains a simple HTML document with 
rudimentary formatting. 

Also, notice the location of the template (4). 

Let's look inside the user template directory for this template. Doing so will give us clues 
about the necessary template files and their structure. See Figure 13.31.2.7 (below). 


Name 


w ™ Simple Project Template example 
fp-info-cache 
v FJ meta 
E brd.png 
icon.png 
info.html 


QB Prj 1- LED torch.kicad_pcb | 
Prj 1- LED torch.kicad_prl 

CU Prj 1- LED torch.kicad_pro 

= Prj 1 - LED torch.kicad_sch 


13.31.2.7: The contents of a user project template directory. 
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Two groups of files compose a user project template: 
1. Project meta. 
2. Project files. 


The project metafiles are stored inside a folder with the name "meta." At a minimum, the 
meta folder must contain "icon.png" and "info.html." The PNG file is used to create an icon 
for the template (see item "2" in Figure 13.31.2.6). The PNG image must have a resolution 
of 64x64 pixels. 

The HTML file composes the contents of the information pane (see item "3" in Figure 
13.31.2.6). You can include additional files in the meta folder if you wish. For example, I 
have added a file named "brd.png" to display a small image of the layout in the information 
window. I use the file "brd.png" in my HTML code. 


The project files are the three primary files of any KiCad project: 
1. The project file, ".kicad_pro". 
2. The schematic file, ".kicad_sch". 
3. The layout file, ".kicad_pcb". 


You can get those files from your source KiCad project and copy them into the project tem- 
plate folder. To create this project template for this example, I simply copied the files I list 
above from my LED torch project. I did not make any changes to those files. 


Below you can see the contents of the HTML file: 


<html> 

<head></head> 

<body> 

<p>This is a an example project template.</p> 
<p>I have created this template from the 
first project of the course "KiCad Like a 
Pros rd re ditaion/p> 

<br> 

<img src="brd.png"> 

<br> 

<img src="icon.png"> 

</body> 

</html> 


The paths are all relative to the location of the HTML file. You can also use regular HTTP 
links to external web pages. 

Once you have created the new project template and stored it in the appropriate location, 
you can use it. In the KiCad project window, click File, and select "New Project from Tem- 
plate...". The Project Template Selector will appear (see Figure 13.31.2.6 above). Select the 
"User Templates" tab, and click on the project template icon. Then click "OK" and choose a 
name and location for the new project. 
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Your new project is now ready to use, with its schematic and layout editor populated with 
the symbols and footprints inherited from the template (Figure 13.31.2.8): 


OFT TETT E 


Eeschema Pcbnew 


13.31.2.8: The new project, with Pcbnew and Eeschema 
contents inherited from my user project template. 


System and user project templates can save you a lot of time when starting new projects. 
I often capture my new projects when they are early in their development process to use 
them as templates in the future. 


13.32. Archive/unarchive and share a project 

KiCad has a project archiving feature that allows you to create a self-contained ZIP archive 
of your project. Once you have archived your KiCad project, you can store it for later use 
or share it with other people. The project archiver will keep all project dependencies (like 
symbols or footprints) in the archive so that your collaborators (or you) will not need to 
spend any time trying to fix library issues. 

In this chapter, I will show you how to archive and un-archive a project using an example. 
I will archive one of my projects on my Mac OS computer and open it on my Windows 10 
virtual machine. 

First, open a KiCad project. With the KiCad project window showing, click on File, then Ar- 
chive Project (Figure 13.32.1). 


É KiCad File) View Tools Preferences Help Window 


Be Open Project... 

... © Open Recent > 

5 “a Í n Close Project - s 
= | EN save As... _ 
s í BB import non-kicad Project.. > > pe 
= IE a | 
oS 4 3 A ths 
x fs 


Figure 13.32.1: Archive a KiCad project. 
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KiCad will ask for a name and save location for the archive, and then create a new ZIP file 
(Figure 13.32.2): 


Actions Projet Hes 


tcs da [ESP3Z Ciona devii shared 


an 


=>» B- Daise a Pro Se Pra. E - 


> EZ new prefect trom somos 

+ E An LEO Watts Clock 
> TZ new project trom lermpistw 
+ D PA 1- LED torah 


> DD Brnadtnnaret Power Dely prepari Nave 


Nev Foto 


101-90 paiectad, 2.02 TB acuda me Einud 


Figure 13.32.2: New archive is created. 


With the new archive ZIP file available, I can copy it to my Windows 10 virtual machine (or 
a collaborator that used KiCad 6 on Windows). See "1" in Figure 13.32.3 below: 


‘Schematic Editor 
aft Me preyeet ereman 


Symbol Editor 
EN giobal and/or peaject schematic symbol Avaris 


Convert bitmap images to schematic symbols or PCB footprints 


Calculator Tools 
Show toot for cofcutating resistance current cqpacity, etc. 


Drawing Sheet Editor 
Exit drawang sheet borders ond nte biocts for une at schematics and PCB deniges 


Local path: monitoring folder changes 


Figure 13.32.3: Unarchviging this archive in KiCad 6 running on Windows 10. 
In the KiCad 6 project window, click on File and "Unarchive Project...". KiCad will ask you to 


select the archive file, so use the file browser to locate the ZIP file and click Open (Figure 
13.32.4). 
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OB ino project loaded] —Kicad E D 
File View Tools Preferences Help 
CD unzip Project x 
- ~ t dm» ThisPC » Desktop » v 6 Search Desktop 
Organise + New folder Ex“ p 17] 
la Downloads # ^ Name Date modified Type Sze 
Pictures * 
> T Downloads File folder 
B Documents # 
T imported project File folder 
© This PC T Make a Drone - resources File folder 
y 3D Objects T temp (do not delete) File folder 
æ Desktop Í ESP32 Clone devkit shared Compressed (zipp.. 524 KB 
5 Documents | ESP32 Clone devkit Compressed (zipp. 524 KB 
4 Downloads 
Y Music 
T Pictures 
W videos 
& Local Disk (C9 N 
= Shared Folders ( 
eas y, 
File name: |ESP32 Clone devkit shared ~| Zip file zip) y 
= 


Figure 13.32.4: Navigating to the archive ZIP file. 


Next, KiCad will ask you for a destination location for the unarchived project. I'll save mine 
to the desktop (Figure 13.32.5): 


fie View Tools Preferences Help 
OD target Directory x 


€ “4 T » ThisPC » Desktop » new shared project from Peter Search new shared project fr 


Organise v New folder 0 


4 Downloads a Date modified 

e Pictures 

= Documents No items match your search. 
© This Pc 

J 30 Objects 


4 Downloads 

T Music 
Pictures 

W Videos 

& Local Disk (C) 
= Shared Folders ¢ 


{v 


Folder: | new shared project from Peter 


Figure 13.32.5: Select a destination for the unarchived project. 


Navigate to the new folder, and look inside. You will see the contents of the project that I 
archived on my MacOS computer (Figure 13.32.6): 
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T| A T a pew shared project from Peter 
New nem + + Select all 
x A Y 
E] Easy access > ES Select none 
Pinto Quick Cop : Move Delete Me New Properties 
access : . folder > ie Hatory invest selection 
Chipboard Organese Nes Open Select 
+A new shared project from Peter 
oh Qisck access 
E Desktop 2 © ESP32 Devhit Clone Gerbers 
$ Downloads + * libraries 
$ Pictures ESP32 Clone dedit 
AA ESP32 Clone devkit.kicad_pri 
CD esp32 clone devkit 
© This PC ESP32 Clone devist 
P 30 Objects symelib-table 
EA Desktop 
Š Documents 


Figure 13.32.6: The contents of the unarchived project. 


Still working in Windows 10, go to KiCad and open the project. You will see the project set- 
tings and the editor contents as they were when the archive was created (Figure 13.32.7). 


Project window w Schematic E Layout 


Figure 13.32.7: The project, unarchived in Windows 10. 


KiCad's Archive Project tool provides a simple way to share projects with other people or 
safely store them. 


13.33. Buses 

In cases where you have several wires that belong to the same functional group, buses can 
help reduce clutter and risk of errors. 

Let's look at an example. Say you want to connect a Z80 microprocessor to a memory chip. 
This connection requires a lot of wires for the address and data. In Eeschema, you would 
start with an arrangement like the one in Figure 13.33.1. Our objective is to connect pins 
AO to A15 from the CPU to the pins with the same name on the RAM module and do the 
same for the data pins. 
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u? 
628128 


Figure 13.33.1: Let's connect the CPU to the RAM using buses. 


You can use normal wires, and the schematic would be correct, although very (visually) 
busy. Instead, we will use the bus option, and create two busses, one for the address pins 
and one for the data pins. To do that, you will use two tools from the side menu, the Bus 
tool ("1", in the figure below), and the Bus Entry tool("2"). 


Ex: 
a»: 
+ 


A 
Figure 13.33.2: The Bus and Bus Entry tools. 


Use the Bus tool first to draw a bus line in between the CPU and the RAM. In Figure 13.33.3 
I have drawn a bus with this particular shape. It doesn't have to look like this; the exact 
shape is up to you. 
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Figure 13.33.3: A bus is depicted by a thick blue line. 


Next, use the Bus entry tool to create entry points from the pins to the bus. Attach the 
bus entries to the bus line (Figure 33.4), and then use a normal wire to connect the bus 
entry lines to the CPU pins if the bus entry lines themselves are not long enough (Figure 
13.33.5). You can also move the bus entry line if needed to align them better. 


Figure 13.33.4: Bus entry lines for pins AO to A3. 


Figure 13.33.5: Using normal wires to connect the pins to the bus entries. 
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Do the same thing on the RAM module side. Your schematic will look like the example in 
Figure 13.33.6. In this example, I have grounded A16 of the RAM module since the CPU 
address bus can only drive 16-bit addresses (not 17 bits, as the RAM module is capable of). 


u? 
Z80CPU 


Figure 13.33.6: The Address bus, unlabeled. 


To complete the bus wiring, you need to label each bus entry point. The labels allow Ee- 
schema to know which pins within the bus are electrically connected. To quickly set create 
the labels, use the net label button, label the first net with 'A1', and then continue by using 
the Insert key to insert the rest of the labels automatically. Each time you press Insert, the 
next label, properly numbered, will appear. When you complete all labels on the CPU side, 
up to A15, manually create the next label as 'AO' and continue using the Insert key. The 
final result looks like the example in Figure 13.33.7. 
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u? 
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Figure 13.33.7: The address bus is now labeled. 


Repeat the same process to wire the data bus. The result is in Figure 13.33.8. 


A 
Z80CPU 


Figure 13.33.8: The data and address buses are fully wired. 
As you can see, the resulting schematic is clear and easy to read. The two buses contain 


invisible but real electrical connections. When you import the netlist file into Pcbnew, these 
connections will be converted into individual tracks. 
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13.34. Calculate the width of a trace 

KiCad includes a calculator that you can use to precisely work out what the width of a track 
should be according to various parameters, like the current you wish to convey through 
the trace, its total length, and the maximum temperature rise when that current is flowing 
through it. You can use this calculator to find out the minimum trace width, or you can 
rely on your experience and choose a much larger width than the standard width of signal 
traces. 

To use the calculator, open the KiCad launcher window and click on the calculator icon(Fig- 
ure 13.34.1). 


= 
eee pic_programmer — KiCad 
Project Files: 
ic_programmer.kicad_pro ‘Schematic Editor 
œ = 3 Edil the project schematic 
E pic_orogrammer-backups 
e | lbs 
Da pic_programmer.kiead_peb Edit global and/or project schematic symbol libraries 
5 
le, -kicad_sch 
E plc_programmer. scl neces 
Ss Fett the project PCB deeign 
BR BRR) Footprint Editor 
e EAN glob) and/or project PCH tootprint Abraries 
Gerber Viewer 
Preview Gerber files 


@ z Show tools for caloulating resistance, current capacity, etc. 


| ==) Edi drawing shast borders anc title blocks for uae in schematics and PCB designe 


[och calculator opened [pid=66860) 


Figure 13.34.1: The calculator is available via the KiCad project window. 


The calculator app contains multiple calculators. One of them is the Track Width calcula- 
tor. Select it by clicking on its tab. Fill in the values that best describe your power track 
requirements. For a typical Arduino gadget, the values that you see in Figure 13.34.2 are 
reasonable. I have only altered the conductor length value to 20mm to better match the 
power trace length of one of my PCB projects. I tend to overshoot these values to ensure 
that the trace width that the calculator returns can comfortably cover the requirements. 
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eco PCB Calculator 


Regulators RF Attenustors E-Series ColorCode  Transline  ViaSize = Track Width Eecpical Spacing Board Classes 


Parameters External Layer Traces: 
Current: 1.0 A Trace width; 0.300387 m E 
Temperature rise; 10.0 c Trace thickness: 0.035 m E 
Conductor length; 20 mn E ‘Meus (CANO TiS. W 
Copper resistivity: 1.726-08 Am Resistance: 00327197 A 
Voltage drop: 0.0127187 v 
Il you specify the maximum currant, than e trace widihs wil be calculated to suit omarion: 00349307 * 
M you specify one of the trace widths, the maximum current It can handle will be calcutatod. The width for the other trace do also handle this current wil 
then be calculated. 
The controling value is shown In bok. 
The calculations are valid for currents up 10 28 A (external) or 17.5 A (intemal), temperature rises up to 100 °C, and widths of up to 400 mi (10 mm). 
The formula, trom IPG 2221, is 
lake aT q 
where: Interna! Layer Traces 
Pm A lard O 
at fe fee above am! 
WH = width and thickness In mils Trace width: 0.781437 m B 
K = 0.024 for internal traces ar 0.048 for extamal traces Trace thickness: 0.035 m E 


Cross-section ares: 00273503 tren 
Resistance: 0.0128776 o 
Voltage drop; 00125776 Y 
Powar joss 0.0128778 w 


Reset to Defaults 


Figure 13.34.2:The Track Width calculator. 


At the top right corner of the calculator, there is a field to provide the trace thickness. This is 
a value that you don't have control over and is defined by the manufacturer's specifications 
(some manufacturers allow you to select the weight of your copper trace, but for simplicity, 
let's assume here that this is fixed). The default value, 0.035 mm, seems to be an industry 
standard. Manufacturers typically make their boards with that trace thickness. To be sure, 
either search your preferred manufacturer's website for their trace thickness or ask them. 
As you type in the parameters, the calculator returns the suggested trace width. In the 
example of 13.34.2, the suggested width is 0.30 mm. 


13.35. Design a custom schematic sheet 

You can create a custom version of the sheet layout. You can use your custom sheet to 
replace the default one in Eeschema. A popular reason for doing that is to include a logo 
on every project page. 

In this recipe, you will learn how to create a simple custom sheet layout. The only differ- 
ence between the default layout and the one we are about to create is that the custom one 
contains a logo graphic. Once you have your custom sheet layout file, you can use it in all 
your schematics. 

To create and edit sheet layouts, KiCad provides a helper application called «Drawing Sheet 
Editor.» To open this editor, go back to the KiCad project manager, and click on the Drawing 
Sheet Editor button at the bottom of the right pane (Figure 13.35.1). 
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Project: (Users/peter/Library/Mabile Do... Clock/4x8x8 LED Matrix Clock.kicad_pro 


Figure 13.35.1: Starting the Drawing Sheet Editor. 


The editor will start, showing the default layout. You can choose to work and edit the default 
layout, create a new one, or load and edit an existing layout. 


Drawing Sheet Editor F Edit V E spa Profarances 


[no drawing sheet loaded] — Drawing Sheet Editor 
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Figure 13.35.2: The Drawing Sheet Editor showing the default sheet layout. 
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A blank layout is empty of any borderlines and text placeholders, giving you maximum 
freedom to design. You can create a blank layout by choosing "New" from the File menu 
or clicking on the new document button in the top toolbar. You can also open an existing 
layout so that you can modify it to your requirements—KiCad ships with several sheets that 
you can use as-is in your schematics or modify them. To open a sheet layout, click on the 
Open button from the top toolbar and browse for the sheet you want to work on. 


[no drawing sheet loaded] — Drawing Sheet Editor 
Densa CODO ANM TAGA. Loft Toppanrcome S Panel z 


=~ fie E ran B Q item Prop_ General O.. 


Folder uhared with File Sharing 
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> D raspborrypi hat 
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> E sima 2M00-discovery-shiela 
> D t-stetiaris-boosterpackag_min 


> EZ EuroCardommxi0dmm 
> EZ EuroCardt60mmxi00mm_holes 
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= A2_1905457-1099_180720.-Y1435-2014_EN.kicad_aks 
= A2J505457-1099_190720.-04-COmpact_DE.kicod wis 
= A2J505457-1999.150720..04-combact_EN Kicad_ws 


X 
cane 


Figure 13.35.3: Open an existing sheet layout to edit. 


If you don't remember where to find the schematic sheet layout files in your instance of 
KiCad, go back to the KiCad project window and select "Configure Paths" from the Prefer- 
ences menu. In the Environment Variables table, look for the path stored in the KICAD6_ 
TEMPLATE_DIR variable. 
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ftps Plank binned men FT schematic Editor 
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3D Search Paths 


Figure 13.35.4: The path to my KiCad schematic editor sheet layout files. 


For this example, I will be using the sheet layout with the filename "A2_1505457-1999 __ 
1507200-2004_EN.kicad_wks". You can see the template below: 


e... A2_1505457-1999_1507200-2004_EN — Drawing Sheet Editar 
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The editor provides drawing tools in the right toolbar and a properties pane on the right 
side. You can draw lines, boxes and add text. You can also insert images. 

Each element has properties that you can edit in the properties pane. For example, below, 
I have used the line tool to draw a single line and then changed the line width to 5 mm in 
the properties pane: 


EN — Drawing Sheet Editor 


Br Page 1 15) 


k Properties 
Item Properties General Options 
á | Line Show on all pages 15) 
ml | Comment: 
1f Position 
[az] X: 36.609 mm 
[a | © 228.5822 mm 
o From: Lower Right 
| End Position 
x: 34,069 mm 
Y: 149.8422 mm 
From; Lower Right 
ine width: 5 mm 
Repeat Parameters 
Count: 1 
Step X: 0 mm 
Step Y: 0 mm 


Figure 13.35.6: Every element has properties. 
The most interesting and useful part of the sheet is the information box that contains the 


text placeholders. In the example below, I have selected the placeholder "${COMPANY}" to 
display its properties in the right pane (see below). 
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Apply 


Figure 13.35.7: Editing the "COMPANY" placeholder. 


In the Properties pane, I have added the word «Testing» in the text box, followed by the 
«${COMPANY}» variable in the following line («1» in the figure above). Click «Apply» («2») 
to finish editing this text placeholder, and then save the sheet editor. 
Return to Eeschema, and bring up the Page Settings window (File —> Page Settings). Use 
the folder button to navigate and select the sheet layout you edited in the previous step in 
the File field. Notice that the «Company» placeholder has a field where you can type text. 
In other words, the placeholders that you define in the sheet editor become text fields in 
the Page Settings window of Eeschema. In the example below, I have typed some text 


before clicking «OK.» 
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... Page Settings 


Paper Drawing Sheet 
Size: | 
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Orientation: 
Landscape ic] Title Block E 


Number of sheets: 1 Sheet number: 1 
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concer SD 


Dir smn 
Figure 13.35.8: Setting a value for the Company text field. 


INER, 


pa 


In Eeschema, the information box shows the text you provided in the Page Settings text 
fields using the edited sheet layout. You can see the result of this work below: 


Approved by 


Document status 


A| 4x8x8 LED Matrix Display ClodiRey. |Date of issue |Lang Sheet 


Figure 13.35.9: Using the customized sheet layout in this schematic. 
You can also use formatting symbols to automatically display information such as the KiCad 


version used, current date, sheet number, etc. You can see the available format symbols 
in the table below. 
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Symbol Description 


%K KiCad version 

%Z Paper format name 
%Y Company name 
%D Date 

%R Revision 

%S Sheet number 

%N Number of sheets 
%Cx Comment (x = 0 to 9 to identify the comment) 
%F Filename 

%P Sheet path 

%T Title 


Table 13.35.1: A list of format symbols available in KiCad. 


Another modification you can make is to add an image, such as a logo, to decorate the 
information box. Below, I have used the image tool from the right toolbar to add a PNG 
image in the Company text box: 


> A = =) SQAQ FD eA Left Top paper corner Page 1 


Document type Document status 
${COMMENT2} S{COMMENTS} 
Ti Ss e 
FL E tie. Supplementary title $(COMMENTA) 
S${TITLE} Rev, Lang. 
${REVISIÐ DO KE MM 
aa . ¡EP 


A A A) AA 


7 oe BDOs » 


Figure 13.35.10: Added an image to the project information box. 


Save the sheet layout and return to Eeschema. The schematic information box will now 
display the logo: 
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O°: 


Nounting 


jole 


Responsible dept. |Technical reference Created by Approved by D 


Document type Document status 


Testing Title, Supplementary title 
Tech Explorations 


Figure 13.35.11: The image appears in the schematic information box. 


You can use the same sheet layout in any of your projects simply by loading the sheet file 
to the project through the 'File' field in Page Settings. 
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Projects, Tips, and Recipes 
Mastering PCB design with real-world projects 


This book will help you practice your new KiCad 6 skills by challenging 
you in a series of two real-world projects, supported by a comprehensive 
set of recipes with detailed instructions on how to achieve a variety of 
simple and complex tasks. 

Design the PCBs for an Arduino-powered datalogger and a custom 
ESP32 board. 

Understand the finer details of the interactive router and how to manage 
KiCad project teams with Git, and much more. 


KiCad 6 is a modern, cross-platform application suite built around schema- 
tic and design editors. This stable and mature PCB tool is a perfect fit for 
electronic engineers and hobbyists. With KiCad 6, you can create PCBs 
of any complexity and size without the constraints associated with the 
commercial packages. 

Here are the most significant improvements and features in KiCad 6, 
both over and under the hood: 


Modern user interface, completely redesigned from earlier versions 

Improved and customizable electrical and design rule checkers 

Theme editor allowing you to fully customize the look of KiCad on 
your screen 

Ability to import projects from Eagle, CADSTART, and more 

Enhanced bus handling 

Full control over the presentation of information by the layout editor: 
set the visibility, color, and attribute of any board element, and create 
presets 

- Filters define which elements of a layout are selectable 

Enhanced interactive router helps you draw single tracks and diffe- 
rential pairs with precision 

- New or enhanced tools to draw tracks, measure distances, tune 
track lengths, etc. 

Enhanced tool for creating filled zones 

- A customizable coordinate system facilitates data exchange with 
other CAD applications 

- Realistic ray-tracing capable 3D viewer 

Huge community of contributors that make KiCad better every day 

Rich repositories of symbol, footprint, and 3D shape libraries 
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